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HELP DOCUMENTATION IS ALSO AVAILABLE ON: 

WRITING MACROS (HELP MACRO) CREATING PICTURES(HELP PIX) 

DEV ICF USAGE (HELP DEV) ARITHMETIC PROGRAMMING < HELP FORTRAN) 

>»»>»>>»>TYPE "HELP HELP" TO GET MORE INFORMATION<<<<<<<<<<<< 

// ****************************************************************dev 

DEV 


DEVICE CONVENTIONS IN GRASS2 


"DEV" IN GRASS GENERALLY MEANS ANYTHING KNOWN TO THE SYSTEM 
THAT CAN HOLD A VALUE FROM -32768 TO +32767 (THE LIMITS OF A 
16-BIT NUMBER). BY CONTRAST. FLOATING POINT NUMBERS IN GRASS 
HAVE MUCH HIGHER RANGES AND TAKE UP MORE BITS AND ARE RELATIVELY 
TIME-CONSUMING TO CONVERT TO INTEGER. 16-BIT NUMBERS ARE WHAT 
THE VECTOR GENERAL(VG) FEEDS ON, AND FEEDING THE VG IS WHAT GRASS IS 
ALL ABOUT AT MACHINE LEVEL. 

SO, THERE'S A BASIC DICHOTOMY IN GRASS ARITHMETIC BETWEEN 
FIXED AND FLOATING POINT NUMBERS. ALL DEV'S ARE FIXED POINT, AND 
CAN BE TIED DIRECTLY TO THE 16-BIT REGISTERS IN THE VG. DEV'S 
CURRENTLY INCLUDE DIALS, FIXED VARIABLES, FIXED ARRAYS AND, IN 
SOME CASES, FIXEO POINT EXPRESSIONS. THUS, IN 

A=B+D0/10 

EVERYTHING BUT THE 10 AND THE =,+,/ ARE DEV'S BUT IN 

FA=K+SIN(FB)*FC 

ONLY THE K IS A DEV (SEE HELP HELP FOR DEFINITIONS HERE). 

NOW, GRASS USES ARITHMETIC VARIABLES THAT ALREADY HAVE 
NAMES. THIS ELIMINATES THE DECLARE STATEMENTS THAT ARE SO 
CUMBERSOME IN MANY PROGRAMMING LANGUAGES AND ALSO VASTLY SIMPLI¬ 
FIES WHAT GRASS HAS TO DO TO FIGURE OUT WHAT YOU'VE TYPED. SOME¬ 
DAY, WE MAY DO SOMETHING ABOUT LETTING PEOPLE HAVE ARBITRARY 
VARIABLE NAMES, BUT FOP THE TIME BEING, THE LEGAL DEV'S ARE: 
ARITHMETIC: 

A-Z 

VA-VZ 

WA-WZ 

iLOCAL ARITHMETIC 
LA-LZ 

ARRAY 


A A ( • . • ) — A M ( . . . ) 
SPECIAL ARITHMETIC: 


OA-OH 


SA-SH 

CA-CH 

MA-MZ 


AND 


QA-QZ AND 


NORMAL EXCEPT ALSO PUT OUT VOLTAGES TO THE IMAGE 
PROCESSOR. 0=0 VOLTS, 127=+1 VOLT, -128=-1 VOLT 
(EXPLAINED MORE LATER). 

CONVERSION TO SINE FUNCTION (EXPLAINED LATER) 
CONVERSION TO COSINE FUNCTION (EXPLAINED LATER) 
NA-NZ LINEAR TIME-BASED VARIABLES 

(SEE BELOW FOR DETAILED EXPLANATION) 
RA-RZ SINUSOIDAL TIME-BASED VARIABLES 


INTERACTIVE CONTROL DIALS, ETC: 

D0-D9 TEN CONTROL DIALS 
S0-S9 TEN SLIDE POTENTIOMETERS 

P0-P3 ' FOUR MORE CONTROL DIALS 

JX,JY,JZ JOYSTICK #1 
KX,KY,KZ JOYSTICK tf 2 

TX,TY,TZ TABLET (TZ=1 FOR PRESS, 0 FOR NEAR & -1 FOR FAR) 


DEV'S CAN BE USED IN ART IHMETIC EXPRESSIONS (EXCEPT THAT YOU 
CANNOT WRITE TO DIALS/POTS/ETC.) AND THEY ALSO CAN BE ATTACHED TO 
ROTATIONS, TRANSLATIONS, SCALING AND SO ON. THIS LATTER CONVENI¬ 
ENCE ACTUALLY REQUIRES SOME COMPLICATED SYSTEMS PROGRAMMING, 
WHICH YOU SHOULDN'T WORRY ABOUT. ANYWAY, WHEN BEING USED IN RO¬ 
TATE, MOVE. SCALE, CUTOFF, SETINT, SETCQ. AND SETORG, THE FOLLOW¬ 
ING RULES APPLY TO DEV'S: 


iRULE i: IF THE DEV IS SPECIFIED ALONE, THE SYSTEM LOOKS UP ITS 
VALUE AND USES IT EVERY 1/60 SECOND. THIS IS WHAT GIVES THE 
INSTANT-SEEMING RFSPONSE TO CHANGING DIALS, VARIABLES, ETC. 

EXAMPLE: SCALE PIX.DO 

RULE 2: IF THE DEV IS PART OF AN EXPRESSION, IT IS EVALUATED 
ONE-TIME ONLY AND USED AS A CONSTANT: 

EXAMPLE: SCALE PIX,D9/100+A 

PIX IS SCALED ON THE VALUE OF D9/100+A AT THE INSTANT THE 

^ ^ ^, rx + rv/ro i it- r- r> t r~ a r>n on cua mod T uc c r a t C nc 



WHERE SINGLE VARIABLES ARE DESIRED. FAKE GRASS OUT BY DOING 
SOMETHING LIKE (A) OR A+0 TO MAKE IT LOOK LIKE AN EXPRES¬ 
SION. NOTE THAT CONSTANTS ALONE ARE OK TOO. FOR INSTANCE, 
SCALE PIX,10000 IS THE SAME NOW AS 
A- 10000 
SCALE PIX,A 

FIX PIX (SEE HELP FIX) 

EXCEPT THAT IT IS FASTER, NEATER AND CLEANER. 


RULE 31 IF AN = SIGN PPECEEDS A FIXED-POINT EXPESSION, THE EX¬ 
PRESSION IS AUTOMATICALLY COMPILED AND THEN RE-EVALUATED 
EVERY 1/60 SECOND. THIS TAKES A SMALL AMOUNT OF MEMORY SO 
IT SHOULDN'T BE USED FOR SILLY THINGS LIKE SCALE SAM,=D0 
WHICH IS COVERED BY RULE 1 ABOVE. 

EXAMPLES: SCALE BEAN,=D0/20 

SCALE BEEP,=A+C*(D-E) 

MOVE SLOOP,=CA+SA,=CB+SB,=CC+SC 


RULE A: IF A DEV OBEYING RULE 1 IS THE ONLY ONE SPECIFIED IN A 
COMMAND EXPECTING MULTI-DEV'S, THE DEV'S LOGICALLY FOLLOWING 
THE ONE SPECIFIED ARE USED AUTOMATICALLY. FOR EXAMPLE! MOVE 
SAM,DO USES DO FOR X TRANSLATION, D1 FOR Y TRANSLATION AND 
D 2 FOR Z TRANSLATION. ROTATE SAM,Y,DO,D1,VL USES VL FOR X 
ROTATION ORIGIN, VM FOR Y ROTATION ORIGIN AND VN FOR Z ROTA¬ 
TION ORIGIN. SIMILARLY, THE CUTOFF COMMAND EXPECTS SIX 
DEV'S SO CUT SAM,D3 USES D3 FOR X HIGH BOUNDARY, 04 FOR X 
LOW BOUNDARY, D5 FOR Y HIGH, D6 FOR Y LOW, D7 FOR Z HIGH AND 
D 8 FOR Z LOW. SEE THE HELPS FOR EACH COMMAND TO SEE HOW 
MANY DEV'S ARE EXPECTED. 

NOW, AND THIS IS IMPORTANT, DEFAULT VALUES ARE ASSUMED 

WHERE ARGUMENTS ARE MISSING IF RULE 4 IS NOT APPLICABLE: 


RULE 


5: IF DEV'S NOT OBEYING RULE 1 ARE USED, DEV'S MISSING AT 
THE END ARE ASSUMED TO TAKE DEFAULT VALUES (0 FOR MOVE, 
SETORG, SETINT, SET CQ, +32767 FOR SCALE (ALL SWITCHES) AND 
CUTOFF X,Y,Z HIGH VALUES, AND -32768 FOR CUTOFF X,Y,Z LOW 
VALUES)• 

EXAMPLES: MOVE SAM,1000 IS THE SAME AS 
MOVE SAM, 1000 ,0,0 


AND 


MOVE SAM,DO,1000 IS THE SAME AS 
MOVE SAM,DO,l000,0 


AND 


MOVE SAM,DO,D1 SETS Z TO ZERO 


AND 


MOVE SAM,=00/10 LEAVES Y AND Z SET TO ZERO 


RULE 61 IF THE ARGUMENTS ARE NULL (I.E. ",,") THE DEV SET¬ 
TING IS LEFT ALONE. FOR EXAMPLE: 

MOVE SAM,1000 MOVES SAM TO 1000,0,0 
FOLLOWED BY 

MOVE SAM,,-1000 MOVES SAM TO 1000,-1000,0 
THIS IS PARTICULARLY USEFUL IN THE CUTOFF COMMAND BECAUSE THE DE¬ 
FAULT VALUES ARE SETUP AS: 

CUT SAM,32767,-32768,32767,-32768,32767,-32768 
WHICH IS NOT SO MUCH FUN TO TYPE IF YOU ONLY WANT TO CHANGE THE 
Z-HIGH COMPONENT. 


NOTE: WHEN RULE 2 IS FOLLOWED IN SPECIFYING A DEV (INCLUDING 

CONSTANTS), THE PICTURE DOES NOT NEED TO BE FIX'ED 


SPECIAL DEV'S 


1. THE DIALS, POTS, ETC. CANNOT BE WRITTEN INTO, THAT IS. THEY 
CANNOT BE ON THE LEFT SIDE OF AN EQUAL'S SIGN OR USED IN GET- 
POINTS 


2. OA-CH ARE DIGITAL-TO-ANALOG OUTPUT VARIABLES THAT 
TEN INTO AND READ FROM AS NORMAL EXCEPT THAT THEY 
VOLTAGES IN A BOX BY THE IMAGE PROCESSOR. THE RANGE 
=127, -1 VOLT =-128, AN 8-BIT RANGE. 


MAY BE WRIT- 
ALSO PRODUCE 
IS +1 VOLT 


3. SA-SH AND CA-CH ARE SPECIAL BECAUSE THEY CAUSE A SINF/COSINE 
CONVERSION WHEN ASSIGNED (I.E. APPEAR ON THE LEFT SIDE OF THE 
,EQUALS SIGN). FOR EXAMPLE: 

SA =0 (SEE HELP FORTRAN) 

PROM SA GIVES 0 (SEE HELP PROMPT) 

SA=256 


180 DEGREES = 
CHANGE OF 1 
VARIABLES ARE 
NOTE THAT 
SAM, 1 0,SA,SB 


PROM SA GIVES 32767 

PI RADIANS = 512 FOR SA-SH AND CA-CH. SC EACH 
EQUALS A CHANGE OF APPROXIMATELY 1/3 DEGREE. THESE 
USEFUL FOR EASILY CREATING SINUSIODAL MOTIONS. 
THE CONVERSIONS WILL NOT TAKE PLACE IN GETP 
SC, SD. THE CONVERSIONS ONLY TAKE PLACE ••OVER" EQUAL 



5. TIME BASED VARIABLES 

THE TIME-BASED VARIABLES COME IN PAIRS (MA-MZ/NA-NZ AND QA- 
QZ/RA-RZ), THE FIRST SET OF WHICH IS LINEAR AND THE SECOND SET IS 
SINUSOIDAL. THE FIRST OF THE PAIR IS USED TO SPECIFY HOW LONG IT 
SHOULD TAKE TO GET TO THE GOAL SET BY THE SECOND OF THE PAIR. 
THE TIME IS SPECIFIED IN 1/60THS OF SECONDS SO MA=240 MEANS 4 
SECONDS. MK=600 MEANS 10 SECONDS, AND SO ON. THE SYSTEM AU¬ 
TOMATICALLY DECREMENTS THE M AND Q VARIAELFS EVERY 1/60 SECOND 
UNTIL THEY ARE ZERO. YOU CAN TEST THE M AND Q VARIABLES LIKE 
NORMAL VARIABLES SO YOU CAN SEE WHEN THEY ARE ZERO, OR WHEN FIVE 
SECONDS ARE UP, AND SO ON. FURTHERMORE, THE LINEAR TIME VARI¬ 
ABLES (MA-MZ) MAY BE CHANGED ANYTIME IN THE COURSE OF EVENTS AND 
THE SYSTEM WILL ADJUST. THE SINUSOIDAL ONES (QA-QZ MAY BE 
CHANGED TOO, BUT THE EFFECT IS NOT TERRIBLY SMOOTH UNLESS THEY 
HAVE ALREADY HIT ZERO. 

BASICALLY, THE IDEA IS TO SET THE TIME VARIABLE AND SET THE 
CORRESPONDING GOAL VARIABLE COA CORRESPONDS TO RA, MJ TO NJ, 
ETC.) ON THE SAME LINE. IT IS IMPORTANT TO SET THE TIME VARI¬ 
ABLE FIPST, BECAUSE THE SYSTEM WILL IMMEDIATELY UPDATE THE 
CORRESPONDING GOAL VARIABLE TO ITS FULL VALUE IF THE TIME VARI¬ 
ABLE IS ZFRO (WHICH IT PROBABLY WOULD BE IF YOU SET THE GOAL 
VARIABLE FIRST). IF YOU DON'T TOUCH THE M'S AND Q'S, YOU CAN USE 
THE R'S AND N'S AS NORMAL VARIABLES, BY THE WAY. 

SOME examples: 

MOVE SAM.NA 

MA=0;NA=-10 00;MA=ISO ? NA=100 00 
THIS WILL TAKE THREE SECONDS TO GO FROM -1000 TO 10000 

SCALE SAM.RC 
QC=120JRC=-15000 
IF QC GT 0,SKIP 0 
QC=360:RC=20000 

THE ABOVE SEQUENCE FIRST SCALES SAM FROM HALF SCALE (BECAUSE 
RC IS ZERO INITIALLY UNLESS OTHERWISE SET) TO MUCH SMALLER 
IN TWO SECONDS, AND THEN UP TO ABOUT 2/3 SCALE IN SIX 
SECONDS, IN A SINUSOIDAL FASHION. NOTE THE WAIT FOR THE QC 
VARIABLE TO HIT ZERO BEFORE PROCEEDING. YOU MAY VERY EASILY 
DOLOOP SEVERAL OF THESE SEQUENCES WITH THE GENERAL TIMING 
BEING UNAFFECTED BY THE AMOUNT OF DOLOOP'ING, SOMETHING WE 
NEVER COULD DO BEFORE. NOTE THAT THE SYSTEM IMMEDIATELY 
STARTS TO DECREMENT THE TIME VARIABLES SO YOU SHOULD SET THE 
GOAL VALUES ON THE SAME LINE WHENEVER POSSIBLE. 


THAT'S ALL FOR THE TIME BEING 


// ******************** ****** ****** **************** ************ MACROS 

MACROS 


WRITING MACROS IN GRASS 
1. WHAT IS A MACRO ANYWAY?? 

A MACRO IN GRASS IS SIMPLY A SET OF COMMANDS. BEFORE GRASS 
HAD MACROS, YOU HAD TO TYPE IN ALL COMMANDS ONE BY ONE. THIS WAS 
OBVIOUSLY QUIT F TEDIOUS WHEN LONG SEQUENCES HAD TO BE REPEATED SO 
WE SOON ALLOWED PEOPLE TO SAVE SETS OF COMMANDS ON THE DISK WITH 
NAMES SO THEY COULD BE RECALLED AT ANY TIME. MACROS, AT FIRST, 
WERE VERY MUCH LIKE PLAYER PIANO ROLLS, BEING ABLE TO STORE ONLY 
LONG SEQUENTIALLY EXECUTED LISTS OF COMMANDS WHICH WERE PLAYEO 
FROM ONE END TO THE OTHER, WITH NO BRANCHING OP REPEATING. THIS 
USE OF MACROS IS STILL VERY COMMON AND VALID, SO HERE'S HOW TO DO 
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1. INTERACTIVELY. BY TYPING A NAME, A COLON, AN OPEN BRACK¬ 
ET, THE COMMANDS WANTED, AND THEN A CLOSE BRACKET LIKE THIS: 

sam:<getdsk globe 

ROTATE GLOBE,Y,DO 
SCALE GLOBE,D1 
MOVE GLOBE,D2> 

THIS ACTION CAUSES A SMALL AMOUNT OF MEMORY (CALLED "CORE” 
BFCAUSF OF THE IRON CORES USED IN THE MEMORY) TO BE ALLOCAT¬ 
ED WITH THE NAME SAM, «D0 SAM" WILL CAUSE GRASS TO EXECUTE 
THE COMMANDS IN SAM ONE-BY-ONE UNTIL IT HITS THE END BRACK¬ 
ET. THEN GRASS RETURNS CONTROL TO WHATEVER ISSUED THE CO, 
WHETHER IT WAS YOU ON THE TELETYPE OR ANOTHER MACRO. NOR¬ 
MALLY, WHEN YOU ARE TYPING ON THE TELETYPE, YOU ARE IN WHAT 
WE CALL "STAR-LEVEL" (BECAUSE THE SYSTEM PRINTS "*"S TO IN¬ 
DICATE A WILLINGNESS TO ACCEPT COMMANDS). 

NORMALLY, MACROS ARE STORED ON THE DISK FOR FUTURE USE 
BY THE FOLLOWING COMMAND: 

PUTDSK SAM 

SAM IS STORED ON THE DISK AS SAM.MAC THE .MAC IS AN EXTEN¬ 
SION AND IT TELLS YOU AND GRASS WHAT TYPE OF THING IS STORED 
ON THE DISK. A .DEC REFERS TO A GRASS PICTURE FILE (FROM 
DECIMAL) AND THE REST OF THE GRASS EXTENSIONS ARE GIVEN IN 
HELP HELP (JUST TYPE HEL° HELP). 

NOW, TO RETRIEVE SAM AT A LATER DATE, SIMPLY TYPE DO 
SAM. IF SAM IS ALREADY IN MEMORY, IT WILL START TO EXECUTE. 
OTHERWISE, IT WILL BE FETCHED FROM THE DISK UNDER THE NAME 
SAM.MAC. DIRDSK WILL TELL YOU WHAT IS ON YOUR DISK AREA. 
YOU MAY ALSO TYPE SAM.MAC OR PRINT SAM.MAC OR GETDSK SAM.MAC 
IF YOU WISH. SEE THE RESPECTIVE HELPS (HELP TYPE, ETC.) FOR 
MORE INFORMATION. 

YOU CAN DELETE A MACRO BY TYPING DELETE SAM (PRESUMING, OF 
COURSE, AS WE HAVE HERE, THAT SAM IS THE NAME OF YOUR MAC¬ 
RO). YOU CAN GET IT ERASED FROM THE DISK BY TYPING DELETE/D 
SAM.MAC. 

OFTEN, HOWEVER, ONE WANTS TO CHANGE A MACRO RATHER THAN 
TYPE IT ALL IN AGAIN. THE NEXT WAY OF ENTERING MACROS ALSO 
ALLOWS CHANGING. 


2. USING THE EDITORS. THERE ARE TWO EDITORS IN GRASS-CALL 

EDIT AND EDIT MNAME—WHERE MNAME IS THE NAME OF ANY MACRO. 
CALL EDIT IS WORDY, ASKS YOU QUESTIONS AND HAS LOTS OF FEED¬ 
BACK. IT IS THE BEST EDITOR TO START WITH. YOU GET IT BY 
TYPING 

RESTART CALL EDIT 

IT WILL ASK YOU FOR.THE NAME AND EXTENSION. IT ALSO ASKS 
FOP SOME INFORMATION ON WHAT THE MACRO IS TO BE USED FOR, AN 
AID TO YOUR OWN DOCUMENTATION. THIS INFORMATION IS STORED 
ON THE DISK UNDER MACROS.DOC WHICH YOU CAN TYPE OR PRINT 
ANYTI ME. 

THE IDEA BEHIND EDITING MACROS IS VERY SIMPLE. MACROS ARE 
COMPOSED OF CHARACTER STRINGS AND THEY LOOK TO THE COMPUTER 
LIKE A BUNCH OF CHILDREN'S BLOCKS WITH LETTERS ON THEM. A 
COMMAND IN GRASS ISA SEQUENCF OF LETTERS (CHARACTERS) IN A 
ROW. ROTATE GLOBE,Y,DO IS ACTUALLY STORED AS 19 BLOCKS IN 
MFMORY (ACTUALLY CALLED 'BYTES'). IF YOU COUNTED THE 
LETTERS AND SPACES, YOU GOT 17. THE TWO EXTRA ARE THE CAR¬ 
RIAGE RETURN <CR > AND LINEFEED <LF> WHICH TELL GRASS THAT 
THE COMMAND LINE IS DONE. (BY CONTRAST, COMPUTER CARDS ARE 
ALWAYS SO CHARACTERS, EVEN THOUGH MOST OFTEN MOST OF THE 
SPACE IS BLANK, A WASTE OF SPACE AND TREES.) GRASS COM¬ 
MANDS, THEN, ARE TERMINATED BY A CRLF SEQUENCE, WHICH, CON¬ 
VENIENTLY, ALSO TELLS THE TELETYPE AND LINE PRINTER WHAT 
MECHANICAL ACTION TO PERFORM WHEN THE END OF THE LINE IS 
HAPPENING. 

SAY YOU HAVE A TEN-LINE MACRO CALLED SAM. THE BASIC 
THINGS YOU WANT TO DO IS ADD LINES (CALLED INSERTING) AND 
TAKE LINES OUT (DELETING). WITH CARD DECKS, THIS IS A PHY¬ 
SICAL PROCESS, BUT IN GRASS, IT IS DONE ELECTRONICALLY AND 
ELECTROMAGNETICALLY. YOU HAVE TO GIVE THE EDITOR INSTRUC¬ 
TIONS THAT LOGICALLY CORRESPOND TO ADDING AND PULLING CARDS 
FROM A DECK. GRASS'S EDITORS USE LINE NUMBERS SO YCU CAN 
EASILY TELL THE COMPUTER WHICH LINES TO DELETE OR AFTER 
WHICH LINE TO INSERT NEW LINES. NORMALLY, YOU ALSO WANT TO 
BE ABIE TO SEE THE CHANGES AS YOU MAKE THEM SO THERE'S A 
TYPE COMMAND AND A PRINT COMMAND, THE LATTFR OF WHICH USES 
THE LINE PRINTER TO GET YOU HARDCOPY TO TAKE HOME AND SAVE. 

MOST PROGRAMMERS ARE TOO LAZY TO TYPE IN A WHOLE NEW 
LINE WHEN SOMETHING SIMPLE HAS TO BE CHANGED. SO WE ALLOW 
CHANGES TO BE MAOE WITHIN A LINE WITH THE CHANGE COMMAND IN 
THE EDITOR. ONCE YOU CALL EDIT, AND ENTER THE MACRO NAMES, 
YOU CAN TYPE HELP TO GET SOME DOCUMENTATION ON THE COMMANDS 
AVAILABLE. YOU MIGHT AS WELL HAVE SOMEONE FRIENDLY HELP YOU 
EDIT THE FIRST TIME OR TWO. 

WHEN YOU ARE FINISHED EDITING, USE THE EXIT COMMAND TO 
GET THE MACRO CHANGED ON THE DISK. THE OTHER EDITOR, EDIT 
MNAME, IS A QUICKY, IN-CORE FDITOR. HELP EDIT DESCRIBES 
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3. MACROS MAY ALSO BE CONSTRUCTED WITH STRING MANIPULATION 
COMMANDS. THIS IS PRETTY ESOTERIC STUFF WHICH WE MAINLY USE 
TO WRITE PROGRAMMING SUPER-LANGUAGES IN GRASS OR GET AROUND 
THINGS THE SYNTAX OF GRASS CANNOT OTHERWISE HANDLE. SEE 
HELP STRINGS WHEN YOU'RE READY FOR THIS. 

**********WNOTE THAT MACROS. WHEN STORED ON THE DISK, OR ENTERED 
WITH THE EDITORS, DO NOT HAVE THE "NAME: <" AT THE BEGINNING OR 
THE AT THF END. ONLY THE TEXT IS USED, ACTUALLY, AND THE 

BRACKETS AFE TO TELL GRASS THAT IT'S A MACRO ONLY DURING THE 
CREATION MODE DESCRIBED IN 1. ABOVE. 


8. MACROS AS COMPUTER PROGRAMS 

WE NORMALLY PROGRAM COMPUTERS USING LOOPS. LOOPS ARE SETS 
OF INSTRUCTIONS REPETITIVELY EXECUTED UNTIL SOME CCNDITTON IS SA¬ 
TISFIED. GRASS DOES A LOT OF INTERNAL HOUSEKEEPING TO HELP THE 
USER GET AROUND WRITING TRIVIAL LOOPS THAT GRAPHICS PROGRAMMING 
IN FORTRAN, SAY, REQUIRES. THE DOLOOP METHOD OF RUNNING MACFOS 
AND THE TIME-BASED VARIABLES AS WELL AS SIMPLE COMMANDS LIKE RO¬ 
TATE, SCALE AND MOVE ALL HELP SET UP THINGS THAT NORMALLY REQUIRE 
COMPLICATED LOOPS IN COMMON GRAPHICS LANGUAGES. NEVERTHELESS, 
LOOPS ARE VERY USEFUL. 

THE COMMAND THAT EXPLICITLY CAUSES LOOPING IS THE SKIP COM¬ 
MAND. IT IS EXACTLY LIKE THE GOTO JAIL IN MONOPOLY OR THE CHUTES 
AND LADDERS IN CHUTES £ LADDERS. LOOPS SHOULD NORMALLY HAVE AN 
ENDING CONDITION, OTHERWISE, AN INFINITE LOOP RESULTS AND YOU 
MUST EXIT WITH A CONTRC-L-C (HOLD THE CTRL KEY DOWN AND HIT THE C 
AT THE SAME TIME, LIKE A SHIFT C—CONTROL-C IS ABBREVIATED |C>. 
|C ALWAYS GETS YOU BACK TO STAR-LEVEL. WHEN A MACRO IS EXECUT¬ 
ING, GRASS WILL NOT ACCEPT COMMANDS FROM THE TELETYPE, WITH EX¬ 
CEPTIONS WHICH YOU WILL DISCOVER ON YOUR OWN. 

AN EXAMPLE OF A LOOP: 

MOVE GL OBE,A,B,C 

A=—1OOOO 

8=—5000 

C=-2000 

XLOOP A=A+50 

B = B + 25 

C=C+10 

IF A LT 15000,SKIP %LOOP 

THIS LOOP WILL MOVE THE GLOBE FROM THE LOWER MIDDLE LEFT CF THE 
SCREEN TO THE UPPER MIDDLE RIGHT IN A FEW SECONDS. WHEN THE 
VALUE OF A IS 15000, THE MACRO STOPS SKIPPING BACKWARDS. YOU 
SHOULD BE ABLE TO FIGURE OUT THE END VALUES OF B AND C BY NOW. 

THE IF STATEMENT WORKS AS FOLLOWS: 

IN THF CASE THAT THE CONDITION IS TRUE, THE STUFF FOL¬ 
LOWING THE COMMA IS EXECUTED. WHEN THE CONDITION IS FALSE, IF 
DEV CONDITION EXPR,STUFF 

THE STUFF FOLLOWING THE COMMA IS IGNORED AND THE NEXT LINE DOWN 
IS PROCESSED. SEE HELP IF FOR MORE DETAILS. 

NOTE THAT ANY COMMANDS MAY BE REPETITIVELY USED IN LOOPS 
EXCEPT THINGS LIKE RESTART, EXIT AND GOTO WHICH CAUSE THE CONTROL 
TO BE TRANSFERRED OUT OF THE MACRO. ROTATE, MOVE AND SCALE USU¬ 
ALLY AREN'T USED INSIDE LOOPS, JUST THE VARIABLES NEED BE CHANGED 
INSIDE THE LOOP. 

MACROS CAN USE OTHER MACROS SIMPLY BY SAYING DO MNAME WITHIN 
A MACRO. THE MNAME IS EXECUTED AND AFTER IT IS FINISHED, CONTROL 
RETURNS TO THE STATEMENT AFTER THE ONE THAT HAD THE DO MNAME IN 
IT. IF THIS IS NOT CLEAR AT THIS POINT, ASK SOMEONE TO EXPLAIN 
THE CONCEPT OF SUBROUTINES. 

C. GETTING MACROS TO TALK TO YOU AND LISTEN TO YOU 


A. TALKING OR MORE PROPERLY, PROMPT*ING: 

THE PROMPT COMMAND TELLS GRASS THAT YOU WANT THE VALUE OR 
CONTENTS OF SOMETHING TYPED ON THE TELETYPE. PROMPT DO WILL TELL 
THE CURRENT VALUE OF DO. PROMPT 700/19 WILL GIVE THE VALUE 
36.84211, SO YOU CAN USE PROMPT AS A RATHER FANCY POCKET ALCULA- 
TOR. SIMILARLY, PROMPT SQR(FA*0> WILL GIVE A RESULT DEPENDING ON 
FA. PROMPT ALSO CAN TYPE MESSAGES (HENCE ITS NAME) TO THF USER, 
LI KE 

PROMPT "WHAT IS YOUR NAME" 

OR PROMPT "THE VALUE OF A IS ",A 

OR PROMPT "THIS MACRO HAS EXECUTED ",X,"TIMES" 

ANY MIX OF VARIABLES AND STUFF IN QUOTES (CALLED STRING LITERALS 
OR JUST LITERALS) MAY BE PRO MPT•ED• PROMPT IS MOST OFTEN LSED IN 
CONJUNCTION WITH THE LISTEN-TO-YOU COMMAND, THE INPUT COMMAND. 


B. INPUT FROM THE TELETYPE 

INPUT IS ONE WAY OF PUTTING VALUES 
WAY IS DIRECT ASSIGNMENT LIKE: 

A= 1 0 
K = K + 50 0 


IN VARIABLES. 


r vntr rur t / * « 


THE OTHER 


tier nr <-\ »*rr_ 



WOULD BE CLUMSY. THE INPUT COMMAND ALWAYS PRINTS OUT A QUESTION 
MARK AND WAITS FOR SOMETHING TO BE TYPED AND CONTINUES TO WAIT 
UNTIL IT SEES A CRLF(CARRIAGE RETURN). SO 

befp:<input a 

PROMPT A*A*3.14159 
SKIP — 2> 

WILL TYPE OUT THE AREA OF A CIRCLE WHOSE RADIUS YOU HAVE TO TYPE 
IN UNTIL YOU HIT A jC TO STOP IT. THIS IS SIMPLER THAN TYPING 
PROMPT A*A*3.14159 EACH TIME. LESS TRIVIAL LOOPS SHOULD OBVIOUS¬ 
LY BE POSSIBLE. 

NORMALLY, THE MACRO SHOULD ASK FOR WHAT IT NEEDS IN THE IN¬ 
PUT. FOR example: 

bfep:< prompt «what is the radius"! 

INPUT A 

PROMPT "THE AREA IS ",A*A*3.14159 
SKIP — 4> 

THE "|" MAKES THE FROM THE INPUT COMMAND APPEAR ON THE SAME 

LINE AS THE PROMPT. YOU SHOULD NOW TRY SOME OF THESE SIMPLE EX¬ 
AMPLES, BECAUSE IT'S GOING TO GET REALLY COMPLICATED HERE CN IN. 

C. PROMPT'ING AND INPUTTING STRING VARIABLES. 

OFTEN A MACRO IS WRITTEN TO BE GENERAL PURPOSE AND WORK ON 
ANY PICTURE NAME. FOR INSTANCE, THE EARLIER MACRO FOR PLAYING 
WITH THE GLOBE COULD BE REWRITTEN TO TAKE ANY PICTURE AS FOLLOWS: 

nfwsam: <prom "which pix”| 

INPUT $ A 
GETDSK $A 
ROTATE $A »Y,DO 
SCALE $ A,D1 
MOVE $A,D2 

PROMPT $ A»” IS MOVING ON D2.D3.D4: SCALING ON 01” 

PROMPT "AND ROTATING AROUND THE Y-AXIS ON D0"> 

THIS IS AN EXAMPLE OF A MACRO THAT SAVES EFFORT. THERE ARE 
SEVERAL GOOD REASONS FOR CREATING MACROS LIKE THIS: FIRST, YOU 
CAN DO THINGS FASTER IF THEY CAN BE REPEATED AT COMPUTER RATHER 
THAN HUMAN TYPING SPEEDS. SECOND, OTHER PEOPLE CAN WRITE MACROS 
FOR YOUR USE AND VICE VERSA. THIRD, YOU CAN CALL THIS MACRO FROM 
OTHER MACROS YOU WRITE AND BUILD UP A LIBRARY OF USEFUL SE¬ 
QUENCES. EVENTUALLY, YOU WILL FIND THAT YOU NEVER DO ANYTHING 
TWICE AND THAT'S GOOD. 

BY THE WAY, IT'S BETTER TO CALL YOUR MACROS SOMETHING OTHER 
THAN SAM AND NEWSAM. MACRO NAMES SHOULD BE SUGGESTIVE OF WHAT 
THEY DO. NOTE THAT MACRO NAMES CAN ONLY BE SIX CHARACTERS LONG. 

D. SOME points: 

1. MACROS ARE ENDED BY FALLING OFF THE END. NO EXPLICIT END 
STATEMENT IS REQUIRED AS IN MOST PROGRAMMING LANGUAGES. SKIPPING 
OFF THE END OF THE MACRO CAUSES IT TO RETURN TO THE MACRO IT WAS 
CALLED FROM. THE RETURN COMMAND ACTUALLY FAKES A SKIP 9999. 
SKIPPING BACKWARDS MORE LINES THAN THERE ARE IS A CONVENIENT WAY 
TO GET BACK TO THE BEGINNING OF A MACRO. 

2. COMMANDS AND ALL NAMES IN GRASS (EXCEPT %LABELS) CAN BE ABBRE¬ 
VIATED TO AS FEW LETTERS AS UNIQUELY IDENTIFY THEM. YOU WILL 
SOON LEARN THAT R IS GOOD ENOUGH FOR ROTATE. AND SO ON, ALL BY 
EXPERIMENTATION. YOU CAN CREATE THE NAMES SAM AND SAMI, EUT NOT 
IN THE ORDER SAMI, SAM, BECAUSE THE SYSTEM ASSUMES SAM IS AN AB¬ 
BREVIATION FOR SAMI ONCE SAMI HAS BEEN CREATED. YOU CANNOT HAVE 
TWdwTHINGS NAMED THE SAME THING, NOR CAN YOU HAVE A MACRO AND A 
PI.CTUPE IN CORE WITH THE SAME NAME. THE SYSTEM WILL YELL AT YOU 
FQR ; TRYING. THESE RESTRICTIONS DO NOT APPLY TO THE DISK NAMES, 
HOWEVER. 

3. MULTIPLE COMMANDS MAY BE PUT ON A SINGLE LINE BY SEPARATING 
THEM WITH SEMI — COLONS. THIS IS VERY USEFUL FOR IF STATEMENTS. 
THERE ARE SEVERAL EXCEPTIONS: SEMI-COLONS MAY NOT BE USED AFTER 
DO'S OR CALL'S AND AFTER THE TEXT COMMAND. AN EXAMPLE: 

PROMPT "HOW OLD ARE YOU" j INPUT B 


4. STUDY SOME OF THE SIMPLE SYSTEM MACROS LIKE MERGE, JOIN, 
BIGGER, BIGGST, AND SO ON. YOU CAN GET COPIES BY TYPING PRINT 
MERGE.MAC 31,3 , ETC. 


E. SOME FINE POINTS... 

COMMENTS IN YOUR MACRO ARE PUT IN BY YOU TO TELL YOURSELF AT 
A LATER DATE WHAT THE LOGIC BEHIND THE MACRO WAS. USE COM¬ 
MENTS IF YOU DO NOT NOW, YOU WILL EVENTUALLY AFTER LEARNING 
THE LESSON THROUGH CONSIDERABLE DUPLICATION OF EFFORT. A COMMENT 
IS SIMPLY ANY LINE BEGINNING WITH A •• . 

SEVERAL THINGS TO NOTE ABOUT COMMENTS: 

1. LINES BEGINNING WITH A * ARE AUTOMATICALLY STRIPPED BY THE 
SYSTEM WHEN THE MACRO IS GOTTEN FROM THE DISK. THIS ACTION IS TO 
SAVE SPACE SINCE COMMENTS SHOULD BE AT LEAST AS MUCH TEXT AS COM- 



NING WITH *'S. 

2. *'D LINES ARE NOT COUNTED BY THE SKIP COMMAND (SEE HELP SKIP), 
BUT THIS IS NOTEWORTHY ONLY IE YOU USE NUMBERS INSTEAD OF XLABELS 
IN YOUR SKIPS. 


use of Is: 

|S TEMPORARILY SUSPENDS EXECUTION OF A MACRO. THE SYSTEM PUTS 
YOU IN "#''-MODE IN WHICH YOU CAN USE ANY COMMAND. TYPICALLY, 
YOU PROMPT VALUES OF MACROS, OR USE THE LIST OP XLIST COMMAND, OR 
(FIX SOMETHING GONE WRONG OR OTHERWISE MISSING. TO GET BACK INTO 
THE MACRO, TYPE RESUME. 


THE COMPILER 

THE COMPILER SPEEDS UP MACROS CONSIDERABLY. SEE HELP COMPILE AND 
HELP EXECUTE. 


LOCAL VARIABLES 

THE VARIABLES LA TO LZ ARE FIXED POINT VARIABLES WHICH ARE KNOWN 
ONLY TO THE MACRO THEY EXIST IN. THEY SHOULD BE USED WHENEVER 
POSSIBLE. THE SET EA TO EZ ARE FLOATING LOCALS. ALL OTHER VARI¬ 
ABLES ARE GLOBAL, WHICH MEANS ALL MACROS KNOW ABOUT THEM. THIS 
MAKES GLOBAL VARIABLES USEFUL FOR PASSING INFORMATION, BUT OCCA¬ 
SIONALLY CONFUSES VALUES. YOU WILL PROBABLY DISCOVER HOW AS YOU 
START TO PROGRAM IN GRASS. AT ANY RATE. YOU CAN REFER TO THE LO¬ 
CAL VARIABLES OF A MACRO CALLED SAM FROM ANOTHER MACRO BY TYPING 
LA SAM. 


Cl cw cDi V PASSTNG VARTARI P<; 

VARIABLES (NUMERIC AND STRING) MAY BE PASSED AS ARGUMENTS (STUFF 
WITH COMMAS AROUND) TO THE DO OR CALL OR EXECUTE COMMANDS. FOR 
EXAMPLE, YOU COULD USE THE MACRO NEWSAM FROM BEFORE BY TYPING: 

DC NEWSAM,GLOBE 

THE STUFF FOLLOWING THE MACRO NAME IS AUTOMATICALLY FED TO THE 
INPUT COMMANDS UNTIL IT RUNS OUT. IF THE MACRO HAS MORE INPUTS 
LEFT, THE PROMPTS, WHICH HAVE BEEN PUT TO SLEEP, SUDDENLY WAKE UP 
AND START ASKING QUESTIONS AGAIN. IF YOU WANT TO SUPPRESS THE 
LAST PROMPTS IN THE MACRO NEWSAM, TOSS IN AN EXTRA COMMA. YOU 
CAN ALSO USF THIS TECHNIQUE WITH SYSTEM MACROS: 

CALL JOIN,THING. IOOO 
OR CALL EDIT,SAM,MAC,,* 

YOU CAN ALSO PASS VARIABLES IN GLOBAL VARIABLES OR STRINGS, BUT 
THE MACRO HAS TO EXPECT THEM THAT WAY. 


/ ERROR MESSAGES 

GRASS*S ERROR REPORTING FACILITIES ARE PRETTY GOOD. WHEN YOU GET 
AN EPRCP, THE SYSTEM STOPS, TYPES QUESTION MARKS, AN ERROR NUMBER 
AND TRIES TO LOCATE THE THING THAT CAUSED THE ERROR BY POINTING 
AT IT WITH A »|» 

IT THEN STICKS YOU IN "#»-MODE, JUST LIKE |S. YOU CAN FIX THE 
PROBLEM, |C TO EXIT, OR, IF YOU DON'T KNOW THIS ERROR NUMBER BY 
HEART YET (THERE'S ABOUT 200 YOU MIGHT RUN INTO), TYPE A **?" FOL¬ 
LOWED BY A <CR> AND THE ERROR WILL BE EXPLAINED AS BEST WE CAN. 
MOST ERRORS ARE EITHER SPELLING ERRORS, RUNNING OUT OF CORE 
SPACE, OR NOT HAVING SOMETHING IN CORE THAT YOU REFER TO. 



// ***** ******* **** ****** ** ************ ************ *********p I X 

P IX 


CREATING PICTURE LISTS IN GRASS 
THERE ARE TWO BASIC WAYS TO CREATE PICTURES IN GRASS: 

1. WITH THE EDITOR CALL EDIT 

USING CALL EDIT, YOU CAN INPUT A PICTURE BY TYPING .DEC FOR 
THE EXTENSION. THE THING.DEC YOU CREATE IS STORED ON THE DISK 
AND MAY BE DISPLAYED WITH A GETDSK THING. THE POINTS THAT MAKE 
UP THE ENDPOINTS OF THE VECTORS YOU WISH TO DRAW MUST BE ENTERED 

as follows: 

X * Y t Z 

WHERE X, Y.’aND Z RANGE FROM +2000 TO -2000. ALL THREE MUST BE 
SPECIFIED, ONE TO A LINE. THUS, A SQUARE IN THE UPPER RIGHT QUA¬ 
DRANT OF THE SCREEN IS REPRESENTED BY: 

0 , 0,0 
1000 , 0,0 
1000 , 1000,0 
0 , 1000,0 
0 , 0,0 

NOTE THAT FIVE POINTS ARE NEEDED TO DRAW FOUR LINES. THE SYSTEM 
ASSUMES LINES ARE DRAWN FROM THE PRESENT POINT TO THE NEXT POINT 
SPECIFIED. NOTE ALSO THAT THE ABOVE FORMAT ALLOWS SPACING AS YOU 
WISH SO FORTRAN 14 FORMAT ON CARDS WITH COMMAS BETWEEN IS ACCEPT¬ 
ABLE TO GRASS. 

TO GO TO THE NEXT POINT WITHOUT DRAWING A VECTOR (CALLED A 
MOVE-NO-DRAW), PUT A "J» ON THE LINES BETWEEN THE POINTS NOT TO 
BF CONNECTED. TO DRAW A "T», THE FOLLOWING IS ACCEPTABLE: 

0 . 0,0 
0 , 1000,0 
J 

-500,1000,0 
500,1000,0 

AND SO ON. THE FIRST POINT IS ALWAYS ASSUMED TO BE A MOVE-NO¬ 
DRAW. 

AFTER TYPING THE POINTS YOU WANT. EXIT FROM THE EDITOR. 


2. WITH PUTPOINT 

THE PUTPOINT COMMAND IS USED TO CONSTRUCT PICTURES IN MAC¬ 
ROS. IT HAS A SIMILAR FORMAT TO THE DISK FORMAT ABOVE, EUT EN¬ 
CODES THE MOVE—NO—DRAWS DIFFERENTLY. HELP PUTPOINT SHOULD BE CON¬ 
SULTED FOR EXACT DETAILS. BRIEFLY, HOWEVER, THE PROCEDURE IS AS 
FOLLOWS: 

A. FIRST. YOU MUST OPEN THE PICTURE NAME. OPEN TELLS GRASS WHAT 
NAME THE ENSUING PUTPOINT'S, DELPOINT'S AND CLOSE WILL REFER TO. 
YOU MUST USE AN OPEN BEFORE PUTP0INT» I NG . 

OPFN BOX 

B. THEN YOU TYPE IN, OR HAVE IN A MACRO: 

PUTP 0,0,0,0 
PUTP 1000,0,0,0 
PUTP 1000,1000,0,0 
PUTP 0,1000,0 
PUTP 0,0,0 

THIS WILL DRAW THE BOX. NOW YOU MUST TELL THE SYSTEM TC CLOSE 
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CLOSE). THE FOURTH ARGUMENT fO PUTPOINT IS COMMONLY CALLED K AND 
SPECIFIES A DRAW IF K=0 , AND A MOVE-NO-DRAW IF K=I. SO THE "T” 
FROM BEFORE LOOKS LIKE: 

OPEN TEE 
PUTP 0.0,0.0 
PUT P 0,100 0,0,0 
PUTP -500,1000,0,1 
PUTP 500,1000,0.0 
CLOSE 

THE NUMBERS ABOVE MAY BE REPLACED BY VARIABLES OR ARITHMETIC EX¬ 
PRESSIONS. FOR EXAMPLE, A MACRO TO DRAW A SERIES OF 200 PARALLEL 
VERTICAL LINES ISJ 


LINE S:<OPEN VERTS 
A=-l0000 

♦SET BEGINNING POSITION OF A 
JSLOOPY B=- 10000 

♦SET B EACH TIME THROUGH LOOP 
PUTP A,B,0,1 

♦MOVE-NO-DRAW TO FIRST POINT 
B=-B 

PUTP A , B , 0,0 
♦DRAW THE LINE 


A=A+ 100 

IF A LT 10000,SK %L00PY 
CLOSE> 

THE ARGUMENTS TO PUTPOINT MAY BE EXPRESSIONS BUT THESE ARE 
EVALUATED INTEGER-WIZE, THAT IS, WITH TRUNCATION TO INTEGER 
VALUES AFTER EACH PART OF THE CALCULATION (SO .01^1000 EQUALS 0). 
YOU CAN USE FLOATING POINT CALCULATIONS TC GET AROUND THIS PROB¬ 
LEM: 


FA=.01*1000 
FB=SIN(FK)^2000 
PUTPOINT FA,FB,0,0 

PUTDSK VERTS WILL STORE THIS ONE ON DISK UNDER VERTS.DEC. 
GETDSK VERTS WILL GET IT BACK (.DEC IS THE ASSUMED EXTENSION FOR 
GETDSK). 


THE DELPOINT COMMAND WILL ERASE THE LAST PUTPOINT. A RUBBER BAND 
EFFECT WILL BE ACHIEVED BY THE FOLLOWING (THE /16 IS FOR SCALING 
PURPOSES): 

PUTPOINT DO/16,01/16,02/16,0 

IF FS1=0.DELPOINT!SK -1 

FSOFF 1;SK -2 

A COUPLE OF THINGS HERE-FIRST, NOTE THAT SEMICOLONS ARE USED TO 

PUT MULTIPLE COMMANDS ON A LINE. SECOND, NOTE THE USE OF THE 
FUNCTION SWITCHES. TRY THIS MACRO OUT. YOU MAY WANT TC TRY TO 
ADD A FUNCTION SWITCH TO CAUSE MOVE-NO-DRAWS, IN WHICH CASE YOU 
NEED A CURSOR MOVED ON D0,D1,02 SO YOU CAN SEE THE MOVE-NO-DRAW 
POINT. YOU MIGHT WANT AN EXIT FUNCTION SWITCH TO DO A CLOSE AL¬ 
SO. NOTE THAT TO SEE THE Z-COORDINATE, YOU WILL HAVE TO ROTATE 
THE PICTURE TOO, AND IF YOU WANT THE CURSOR TO BE ATTACHED, YOU 
WILL HAVF TO FIRST GROUP THE PICTURE AND THE CURSOR AND ROTATE 
THE GROUP (NOT THE PIX). SEE HELP GROUP FOR DETAILS. THIS TYPE 
OF THING GETS MILDLY COMPLICATED, BUT IS VERY INSTRUCTIVE IF YOU 
TRY IT YOURSELF. 


C. CHANGING ENDPOINTS WITH GETPOINT AND ZAPPOINT 

TWO COMMANDS, GETPOINT AND ZAPPOINT ALLOW YOU TO GET AT AND 
CHANGE INDIVIDUAL ENDPOINTS. THEY ARE COMPLIMENTARY AND FUNCTION 
LIKE READ AND WRITE. GETPOINT GETS VALUES INTO VARIABLES AND 
ZAPPOINT CHANGES ENDPOINTS ACCORDING TO THE VALUES GIVEN IN ITS 
VARIABLES. HELP GETPOINT AND HELP ZAPPOINT GIVE ALL THE STRAIGHT 
I NEO. 

THE SPECIAL THING IS THAT K (WHICH CAN ACTUALLY 8E ANY FIXED 
VARIABLE). IS SET TO 0 FOR DRAWS, l FOR MOVE-NO-DRAWS, AND -1 FOR 
END-OF-LIST. FOR EXAMPLE, A MACRO TO MAKE THE FIRST AND LAST 
POINT OF A PICTURE THE SAME (THAT IS, CLOSE THE GAP BETWEEN THE 
FIRST AND LAST VECTORS) COULD BE WRITTEN AS FOLLOWS: 

CLOSUP:<PROM "WHAT PIX TO BE DE-GAPPED"! 

INPUT $N 
N= 1 

GET P $N, l ,A,8,C,D 
N=N+ l 

GET P $N,N,X,Y,Z,K 
IF K NE -1 .SKIP -2 
ZAPP $N,N,A,B.C,K 
PROM ”DONE"> 

AN EXAMPLE TO ADD 5Q0 TO EACH Z IF THE X VALUE IS POSITIVE: 

INCZ:<PROM "PIX NAME”) 

INPUT $A 
N=0 

%MORE N=N+1 
GETP $A,N,A,B,C.D 
IF A GE 0,C=C+ 500 
ZAP SA,N,A,B,C,D 



MERGE.MAC 31.3 , J0IN2.MAC 31.3 AND SO ON. 

/■/ *************************** **** **** ************ «*»***********fortran 

fortran 


GRASS USES SIMPLIFIED FORTRAN-STYLE SYNTAX FOR OOING ARITHMETIC. 
THERE ARE SEVERAL IMPORTANT DIFFERENCES, THOUGH: 

1. VARIABLES IN GRASS HAVE FIXED NAMES (SEE HELP DEV). YOU CANNOT 
HAVE A VARIABLE NAMED "RAT F", FOR EXAMPLE. THIS DECISION 

WAS MADE WHEN DESIGNING GRASS AND IT ELIMINATES THE NEED 
TO TELL THE SYSTEM WHAT TYPE OE VARIABLE (FIXED, FLOATING, 

STRING, ARRAY, ETC.) YOUR ARBITRARILY-NAMED VARIABLE IS. 

IN GRASS, A-Z, VA-VZ, AND WA-WZ ARE FIXED POINT (INTEGER) 
VARIABLES WHOSE RANGE (MAXIMUM AND MINIMUM VALUES) IS 
32767 TO -32768. VARIABLE WZ NORMALLY HAS 32767 IN IT 
SO IF YOU NEED TO KNOW WHAT FULL VALUE OF AN INTEGER 
VARIABLE IS, PROMPT WZ. 

FA-FZ ARE FLOATING POINT VARIABLES WITH TREMENDOUS RANGE. MORE 
COMPUTATION IS REQUIRED TO GIVE THIS RANGE, HOWEVER, SO 
ONE NORMALLY USES FLOATING POINT VARIABLES (CALLED REALS IN 
FORTRAN) ONLY WHEN DOING FANCY CALCULATIONS. 

THERE ARE ALLO VARIABLES KNOWN ONLY WITHIN MACROS. 

THESE ARE CALLFD LOCAL VARIABLES AND HAVE THE NAMES LA-LZ 
(INTEGER) AND EA-EZ(FLOAT ING). SEE HELP DEV FOR MORE INFO. 

THE RULE IS THAT THE TYPE OF VARIABLE IS 
INDICATED BY ITS FIRST LETTER. 

A LIST OF VARIABLES IS GIVEN IN HELP DEV AND HELP HELP 

2. THERE ARE TWO BASIC TYPES OF ARITHMETIC STATEMENTS: ONES WHICH 

INTEGER DESTINATIONS AND ONES WHICH HAVE FLOATING 

DESTINATIONS. FOR REASONS OF EFFICIENCY, ASSIGNMENT STATEMENTS 
(ONES WITH »=* SIGNS) TO INTEGER VARIABLES (LIKE A=...> 

ARE PROCESSED DIFFERENTLY FROM ASSIGNMENTS TO FLOATING VARIABLES. 
FLOATING ASSIGNMENTS ARE MORE GENERAL; INTEGER ASSIGNMENTS ARE 
USED FOR COUNTING, ETC. 

RULE 1. WHEN ASSIGNING TO AN INTEGER VARIABLE, TRUNCATION 

TO INTEGER VALUES IS DONE AFTER EVERY STEP OF THE CALCULATION. 

IN FLOATING ASSIGNMENTS, THE RESULT IS ALWAYS KEPT TO 8 SIGNIF¬ 
ICANT FIGURES. FOR EXAMPLE: 

FD=.Ot 

K=FD*100 EVALUATES TO 0 SINCE THE .01 IS 

TRUNCATED TO 0 FIRST. 

FA=FD*100 EVALUATES TO 10 SINCE THERE IS NO 

TRUNCATI ON. 

RULE 2. AS EXPLAINED IN HELP DEV, ONLY INTEGER VARIABLES, 

OR THINGS THAT EVALUATE TO INTEGER VARIABLES MAY BE DIRECTLY 
ATTACHED TO PICTURE TRANSFORMATIONS (WHICH IS WHAT GRASS 
AS A LANGUAGE IS MOST CONCERNED WITH). YOU CANNOT ROTATE 
SOMETHING ON A FLOATING VARIABLE WITHOUT EXPRESSLY 
CONVERTING IT TO AN INTEGER VARIABLE AS IN THE FOLLOWING: 

ROTATE GLOBE ,Y,P 
XLOOP FP=SIN(FA)*1000 
P=FP 

F A =FA+.0 1 
SKIP %L OOP 

THE P=FP CAUSES A FLOAT ING-TO-INTEGER CONVERSION. 

RULE 3. ONLY FLOATING ASSIGNMENTS CAN USE THE BUILT-IN FUNCTIONS 

(SIN, COS, ATN, EXP, ETC. EXPLAINED BELOW). 

THIS IS ALSO FOR REASONS OF EFFICIENCY. 

RULE 4. ALL.EXTERNAL CONTROL DEV» S (D0-D9, TX.TY.TZ, ETC.) 

ARE INTEGER AND RANGE FROM 32767 TO -32768. 

VARIABLE WZ IS SET TO 32767 TO HELP YOU USE THIS SILLY NUMBER 
(32768 IS REALLY 2 TO THE 15TH POWER). 

RULE 5. BECAUSE OF DIGITAL WRAP-AROUND, 32767+1 EVALUATES TO 

-32768. YOU WILL NOTICE THE EFFECT GF THIS IF YOU TRY THE 
FOLLOWING MACRO: 

MOVE ANYPIX,A 
A= A + 100 
SKIP -1 

THE MEANING OF WRAP-AROUND WILL BE REAL CLEAR. 

RULE 6. DON'T PUT SPACES AROUND THE •=• SIGN. SPACES 
ANYWHERE ELSE ARE OK THOUGH. 

3. IE YOU RUN OUT OF VARIABLES, OR NEED A WAY OF SPECIFYING 

SEQUENCES OF VARIABLES, USE ARRAYS (SEE HELP ARRAY). 

4. PRECEDENCE OF OPERATORS IS AS NORMAL FOR ALGEBRA. 

YOU MAY USE PARENTHESES TO CHANGE THE ORDER OF PRECEDENCE: 

3+4*10 IS 43 
(3+4)*10 IS 70 


er 
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PROMPT FA 
PROMPT SQR(10000) 


6. LOOPING ARITHMETIC STATEMENTS IS DONE JUST LIKE 

ALL OTHER LOOPS IN GRASS. THE SKIP COMMAND IS USED 

FOR TRANSFER WITHIN A MACRO AND THE DO COMMAND IS USED TO 

CALL OTHER MACPOS AS SUBROUTINES. (SEE HELP SKIP. HELP DO). 

7. COMPILING OF MACROS (SEE HELP COMPIL) SPEEDS UP THE 

ARITHMETIC PROCESSING AS MUCH AS 200 TIMES. COMPILING IS 
RECOMMENDED IF YOUR MACRO HAS LOTS OF ARITHTIC 
AND IS RUNNING TOO SLOW FOR YOUR TASTES. 

8. THE AVAILABLE BUILT-IN FUNCTIONS ARE: 

1. SIN(EXPR) WHERE EX PR IS IN RADIANS (3.14159 RADIANS 

EQUALS 180 DEGREES). 

EX: FA=S IN(2.7*FC ) 

2. COS(EXPR) 

EX: FA=COS(SIN(2•74FC)) 

3. ATN(EXPR) ARC TANGENT 

EX: FK=ATN(FE) 

4. LOG(E XPR) .LOG TO THE BASE E 

EX: FD=LOG(1.7E14) 

5. ABS(EXPR) ABSOLUTE VALUE 

ex: ff=abs(fa) 

6. RND(EXPR) RANDOM NUMBER 

ex: ft=rnd(oj^iooo 

THE EXPR IS INCLUDED TO KEEP THE SYNTAX 
CHECKER HAPPY BUT IS NOT USED. 

7. SGN(EXPR) SIGN 

ex: fz=sgn(rndio )) 


FLOATING POINT NUMBERS MAY BE ENTERED IN E FORMAT! 

FD=1.2E7 
FE=—2E-10 

THE LARGEST POSITIVE NUMBER FOLLOWING THE E IS 9808 AND THE SMALLEST 
IS -9808. 

USE TRACE, PROMPT AND LIST TO HELP DEBUG YOUR ARITHMETIC PROGRAMS. 


THAT'S ALL FOR NOW. 

// 4 444 444444444444444 44 4444 444444444444444444444444444444 44444 444444 

/4 

THE EXPLANATION YOU REQUESTED DOES NOT EXIST (CHECK SPELLING). 

// 4444444 44 44444 44 44 4 44 4 4 444 444 4444444444444444444444 444444444444 444 

// 444444444444444444444444444444444444444444444444444444444444444444 

ARRAY 


SYNTAX! ARRAY ARRNAME.EXPR 

OR ARRAY ARRNAMF.LOWER BCUND!UPPER BOUND 

WHERE LOWER AND UPPER ARE EXPR»S 

THE GRASS ARRAY STATEMENT IS LIKE THE DECLARE STATEMENT IN 
PL/1 AND LIKE THE DIMENSION STATEMENT IN FORTRAN. ITS PURPOSE IS TO 
SET UP THE ARRAY'S DIMENSIONS, THAT IS, HOW BIG AN AREA IN CORE YOU 
WANT TO SET ASIDE FOR THE ARRAY. 

ARRAYS HAVE A SPECIAL SET OF NAMES! AA THROUGH AZ. 

THE NORMAL USE OF ARRAY ASSUMES YOUR ARRAY DIMENSIONS 
START AT l AND GO TO THE EXPR. CONSEQUENTLY, 

ARRAY AB, 10 

WILL DIMENSION AN ARRAY TO HAVE 10 INTEGER (LIKE A-Z TYPE) 

ELEMENTS REFERENCED BY AB( 1) ,AB(2 ) ,... ,AB( 10). IN THE SECOND 
CASE, FOR THOSE OF YOU WHO MUST HAVE UNNATURAL LOWER BOUNDS 
TO YOUR ARRAYS, THE LOWER AND UPPER BOUNDS MUST BE EXPRESSLY 
STATED. NOTE THF SPECIAL SYNTAX—A •:• MUST SEPARATE THE EOUNCS. 

MULTI-DIMENSIONAL ARRAYS (UP TO FOUR) MAY BE CREATED TOO. 

YOU SIMPLY INCLUDE THE DIMENSIONS FOR THE EXTRA COLUMNS 
IN THE OBVIOUS WAY: 

ARRAY AQ,10,10,10 

THIS WILL DIMENSION A FLOATING POINT ARRAY 10X10X10. 

MULTI-DIMENSIONAL ARRAYS USF LOTS OF SPACE, SO BE ADVISED. 

THE ARRAY IS CONSIDERED FIXED POINT (INTEGER) IF ITS NAME 
IS AA-AN. THF ARRAY IS FLOATING POINT IF THE ARRAY NAME IS AC-AZ. 

THERE ARE ONLY ARITHMETIC ARRAYS; NO STRING ARRAYS EXIST 
IN GRASS. 

STORING ARRAYS ON THE DISK REQUIRES ASSIGNING A NAME 
WITH THE PUTDSK COMMAND: 

PUTOSK TIARR.APA.AK 

NOTE THE SYNTAX. THE ARRAY NAME ON DISK IS T1ARR.APA. 

YOU COULD SAY PUTDSK AK.ARA.AK BUT YOU MIGHT NOT PEMEMBER WHAT AK.ARA 
WAS FOP. 


ARRAY 



NOTF THAT IT CAN BE CALLED SOMETHING DIFFERENT THIS TIME. BUT YOU 
CANNOT GET FIXED AND FLOATING MIXED UP SO THE FOLLOWING WOULD BE 
UNWISE IN THIS CONTEXT: 

GETDSK TIARR.AP 

SINCE GRASS WOULD ERRONEOUSLY THINK IT WAS A FLOATING ARRAY. 

NOTE ALSO THAT YOU DO NOT USE THE ARRAY COMMANO PRIOR TO 
GETDSK*TNG AN ARRAY—GETDSK DOES THE DIMENSIONING AUTOMATICALLY. 

EXAMPLES t 

THIS SEGMENT OF CODE SETS UP THE ARRAY, AND THE LOCP FILLS 
IT IN WITH THE INPUT COMMAND. 

ARRAY AB♦300 
A =0 

% MORE A = A+1 ;*FIRST ELEMENT 

PROM "ENTER ARRAY ELEMENT #",A| 

INPUT AB{A) 

IF A LE 300.SK XMORE 
PROM "DONE" 

EXAMPLE 21 

A= 120 
H=40 
K = 1 O 

ARRAY AR,4 I 10,(A+H1/L 
AR(4 » 0)=3.14 15 9 
AR( 4, 1 ) =2. 789 
ARC8,16)=.003 

NOTE: OTHER OTHERWISE FILLED, ALL ARRAY ELEMENTS ARE SET TO 0. 

// *:$£*** 4 ************ ** * * ** * * **** **** ********************************* 

/* 

END OF A • S 

// ******************************************************************** 

// ****************************************************************** BACKUP 

BACKUP 

SYNTAX: BACKUP OLDNAME,NEWNAME 

OR 

BACKUP OLDNAME 


SWITCHES: /R 

BACKUP CAUSES THE FILE SPECIFIED BY OLDNAME 
TO BE WRITTEN ONTO DECTAPE (UNIT 0). IF A SECOND ARGUMENT 
IS SUPPLIED THE NEW NAME ON TAPE WILL BE THAT NAME. IF NOT 
THE NAME ON TAPE WILL BE THE SAME AS THAT ON DISK. THE /R SWITCH 
REVERSES THIS TRANSFER CAUSING A FILE ON TAPE TO BE WRITTEN ONTO 
DISK. THE GENERAL FORM OF THE FILENAMES IS FILNAM.EXT #,# . IF THE 
A,# IS NOT SPECIFIED THE DEFAULT IS THE AREA INTO 
WHICH THE USER IS CURRENTLY LOGGED. 

DECTAPE IS ON REMOTE WITH THE WRITE ENABLE SWITCH 
IT HAS BEEN INITIALIZED FOR YOUR AREA. 

BACKUP ROBIN.DEC 

CAUSES THE FILE ROBIN.DEC TO BE WRITTEN ON 
TAPE WITH THE FILE NAME ROBIN.DEC 

BACKUP ROBIN.DEC,JUNK.MAC 

CAUSES THE FILE ROBIN.DEC TO WRITTEN ON 
TAPE WITH THE FILE NAME JUNK.MAC 

BACKUP/R ROBIN.DEC 

CAUSES THE FILE ROBIN.DEC ON TAPE ALREADY TO 
BE WRITTEN ON THE DISK. IT MUST NOT ALREADY 
EXIST ON THE DISK 

// ***************** **** ************************************ ** ** *****Bl_ ANK 

BLANK 

SYNTAX: BLANK PIX ESOTERIC//// 

BLANK ALLOWS THE PIX TO BE UPDATED & GROUPED AND 
SO ON BUT CAUSES THE VECTORS TO BE UNDISPLAYED SO THEY 
DO NOT TAKE UP COMPUTER TIME TO DISPLAY. IT IS 

ALSO USFFUL FOP FLASHING A PIX OFF AND ON. IT IS USEFUL SOMETIMES, 

AS IN CFRTAIN CASES OF PERSP, AND IN SYNCHRONIZING 
ROTATIONS TO NOT HAVE THE PIX PUTLIB'D WHILE AT THE SAME 
TIME, A SET I PIX,-32000 WOULD STILL POSSIBLY ADD TO FLICKER. 

THERE IS ALSO A GETLIB/W OPTION NOW THAT ALLOWS YCL 


BE SURE THE 
ON AND THAT 

examples: 



FLASH YOU NORMALLY GFT WHEN GETLIB'ING A PIX 

UNDER THESE CIRCUMSTANCES. GETL/W ESSENTIALLY DOES A BLANK 
AND THEN A BLANk/R AFTER 1/30 SECOND TO ALLOW ALL THE UPDATES TO 
TAKE EFFECT. IF YOU HAVE NFVER RUN INTO THIS PROBLEM, DON'T 
WORRY ABOUT IT, THOUGH. 

switches: /r TURNS THE VECTORS back on 

examples: blank sam 

TICK 4 
BLANK/R SAM 
SK -3 

THIS WILL FLASH SAM ON AND OFF 15 TIMES A SECOND 
(ONE SECOND EQUALS 60 TICKS). 

// * **** ** ******* * **** ** ** ******** ******** ******** **************** ****** 8L F 

BLEND 


SYNTAX: BLEND PIXl,PIX2,DEV,EXPR 

BLEND TAKES TWO PIX AND DOES A LINEAR INTERPOLATION BETWEEN THEM. 
THE NUMBER OF STEPS IN THE INTERPOLATION IS GIVEN BY EXPR. THE STEP 
YOU ARE AT IS GIVEN BY THE DEV (WHICH FOLLOWS GRASS2 DEV CONVENTIONS). 

THE PIX SHOULD HAVE THE SAME NUMBER OF VECTORS FOP BEST RESULTS, ALTHOUGH 

THE WOPST THAT SHOULD HAPPEN IS SOME RANDOM GARBAGE AT THE END 

OF THE SMALLER PIX OR LOSING SOME OF THE LARGER PIX. THE DEV 

VALUE NORMALLY RANGES FROM THE EXPR VALUE TO ZERO BUT MAY 

EXCEED THESE BOUNDS IF YOU WISH, IN WHICH CASE THE EFFECT IS 

WEIRD BUT OCCASIONALLY INTERESTING. 

BLEND, ONCE STARTED FOR TWO PIX, CONTINUES TO OP ER AT F UNTIL 
BLEND/U PIXl IS TYPED. BLEND USES A LOT OF COMPUTER TIME, SO YOU 
DON'T WANT TO HAVE IT OPERATING WHEN YOU DON'T NEED IT. 

BLEND ALLOWS MANY PIX TO BE BLENDING INTO OTHER 
PIX AT THE SAME TIME, USING MORE COMPUTER TIME, NATURALLY. 

YOU MAY NOTICE THAT DIRCOR AND OTHER THINGS SLOW DOWN A LOT WHEN 
LARGE PIX APE BLENDED. 

BLEND ALSO REQUIRES SCRATCH SPACE EQUIVALENT TO PIXl WHILE 
OPERATING TOO. SO REMEMBER TO BLEND/U WHEN IT'S OVER 

BLEND ALSO WORKS WELL WITH THE TIME-BASED VARIABLES. 


EXAMPLES: BLEND SAM,TOM,DO ,32767 

THIS WILL BLEND SAM TO TOM ON DIALO 
QA=400;BLEND SAM »TOM , QA,40 0 
THIS WILL BLEND SAM TO TOM IN 400 STEPS TAKING JUST 
UNDER SEVEN SECONDS (SEVEN SECONDS = 420 TICKS). 

YOU MAY HAVE TO REVIEW THE TIME BASED VARIABLES TO 
UNDERSTAND THIS ONE. 

BLEND SAM,TOM,100,200 

THIS WILL BLEND SAM HALFWAY TO TOM AND STAY THERE. 
BLEND SAM,TOM,A,1000 
A=A-10 

IE A GT 0,SK -1 
A=A+10 

IF A LT 1000,SK -1 
SK -4 

THIS WILL BLEND TOM TO SAM AND BACK UNTIL STOPPED. 


NOTE THAT A DEV VALUE = ZERO MEANS ALL THE WAY TO THE 
SECOND PIX, AND A DEV VALUE = THE EXPR MEANS PIXl 
WILL LOOK LIKE PIXl. 

SWITCHES: /U UNDO THE BLENDING 

Ex: BLEND/U SAM 


// ******* ****** ****** **** ************ ************ ******************* BUMP 

BUMP 


syntax: bump $var 


STRING MANIPULATION//// 


BUMP IS USED TO STEP THROUGH THE FIXED & FLOATING POINT 
VARIABLE NAMES {A-WZ,FA-FZ,AA-AZ,LA-LZ). THE IDEA IS TO ALLOW 
MACROS TO SETUP CODE TO MOVE, SCALE, ETC. A VARIABLE NUMBER OF 
PICTURES ON VARIABLES. RUMP ONLY WORKS WITH SVAR•S WITH PRGPER 
VARIABLF NAMES IN THEM. WHEN $4='K•, BUMP $A WILL CHANGE THE 
•K' TO 'L* AND SO ON. 'Z* GOES TO *VA' AND »VZ• GOES TO *WA*. 


EXAMPLE: 


PROM "NUMBER OF COPIES" 
INPUT N 
M = 0 

$R='VA» 

M = M +■ 1 

* A= * COPY * , M 
COPY NAME,$A 
SET I SA,$B 
BUMP $B 

IF M LF N, SK -5 


THIS WILL 


SETINT COPY 1 ,V A 

cct tmy \t ra 



FTC. 

// ****************** ***** ****** ** ************** ** ************* ******** 

/* 

THERE NO DESCRIPTION AVAILABLE FOR THIS 

COMMAND NAME HAS BEEN MISSPELLED. - 

// *********** ******** **************** 

// *********** ************ ************ 

CALL 

SYNTAX: CALL MNAME 

CALL IS LIKE 'DO' EXCEPT THAT IT REFERENCES THE COMMON AREA ONLY. 
CALL. AS WELL AS OTHER COMMANDS. MAY BE USED AS AN ARGUMENT TO RESTART. 

EXAMPLES: CALL MERGE.PIXI,PIX2 

CALL EDIT 
RESTART CALL EDIT 

NOTE THAT CALL AUTOMATICALLY GETS THE COMPILED VERSION OF THE 
MACRO FIRST, IF IT EXISTS. TO FORCE USING THE MACRO VERSION 
(NON-COMPILED) TYPE 

DO MNAME.MAC 31,3 


// ****************************************************************** CUTOFF 

CUTOFF 

SYNTAX: CUTOFF PIX.DEVI,DEV2 * DEV3,0EV4,DEV5 » DEV6 

CUTOFF IS A HARDWARE FUNCTION WHICH CUTS OFF THE 
PICTURE EITHER OUTSIDE OR INSIDE A RECTANGULAR BOUNDARY SPECIFIED 
BY THE SIX DEV * S. THE DEV'S REPRESENT THE X-HIGH , X-LCW, Y-HIGH, 

Y-LOW, Z-HIGH AND Z-LOW BOUNDARIES IN THAT ORDER. THE DEFAULT VALUES 

are: 

CUTOFF PNAME,32767,-32768,32767,-32768,32767,-3276€ 

CUTOFF EXPECTS SEVEN VALUES. IF YOU SPECIFY JUST ONE DEV LIKE 
CUTOFF PNAME,D1 

YOU WILL GET D1,D2,D3,DA,D5,D6 AND D7. YOU SHOULD SET 

D1.D3.D5 TO FULL POSITIVE AND D2.D4.D6 TO FULL NEGATIVE TO SEE THE 

PIX. THIS WILL SHOW PN AME AS IT APPEARS WITHIN THE BOUNDARIES 

SET BY THE DIALS. OF COURSE, ANY LEGAL DEV'S ARE OK. (SEE HELP DEV). 

THF /R SWITCH WILL SHOW THE PIX OUTSIDE THE BOUNDARIES. 

NOTE: CUTOFF SEEMS TO SHIFT WHEN SETP IS USED. 

ALSO: CUTOFF IS NOT SOFT'ABLE (SEE HELP SOFT). YOU SHOULD USE THE 
WINDOW COMMAND FOR REAL CLIPPING (SEE HELP WINDOW). 

SWITCHES: /R OUTSIDE INSTEAD OF INSIDE 

examples: cut globe,,,,,,o 

THIS WILL LEAVE THE DEFAULTS FOR ALL BUT Z-LCW 

SO IT WILL SHOW HALF THE GLOBE (ALL POSITIVE Z-POINTS) 

CUT BOX 1 ,DO,=— DO,DO,=-D0,DO,=-DO 
CUT/R BOX2 ,DO,=-DO,DO,=—DO,DO,=-DO 
THIS SEQUENCE WILL DO A CENTER WIPE FROM BOX 1 TO B0X2 
(FIGURE THAT ONE OUT ). 

// ******************************************************************Ct_EAP 

CLEAR 

SYNTAX: CLEAR 

CLEAR SIMPLY CLEARS THE VT05 SCREEN. 

// ******************************************************************* CL O 5 

CLOSEO 


syntax: CLOSE 

CLOSE ENDS THE PIX PREVIOUSLY SPECIFIED BY OPEN. CLOSE 
ALLOWS THE PIX TO BE PUTDSK'S. IT RELEASES ANY SPACE NOT NEEDED. 

AND IT ALLOWS ANOTHER PIX TO BF OPFN'D. 

example: 

OPENO SAM 

PUTPOI 500,500,500,0 
PUTPOI -500,500,500,0 
PUTPOI 0,0,0,0 
PUTPOI 500,500,500,0 
CLOSEO 

// ******************************************************************** CLIP 

CL IP 

SYNTAX: CLIP CL I PEE,CLIP ER,CL IPP ED 

WHERE CL I PEE ,CLI PER, AND CLIPPED ARE PIX 


COMMAND AT THIS TIME, OR 
SORRY 

********************************* 
******************************* CALL 



IT IN THE X AND Y DIRECTIONS SO THAT IT FITS INSIDE ANOTHER PICTURE. 

THE "CLIPPER". AND PUTS THE RESULT IN THE NEW PICTURE, THE "CLIPPED". 

THE "CLIPPER" IS ASSUMED TO BE TWO-DIMENSIONAL, HENCE THE 
Z —COORD INAT ES ARE IGNORED. IT IS ALSO ASSUMED THAT THE "CLIPPER” HAS 
NO JUMPS IN IT, AND THEREFORE IF THERE IS A JUMP, A LINE WILL EE 
ASSUMED IN THE GAP, ALSO, AND THIS IS IMPORTANT, THE FIRST POINT OF 
THE "CLIPPER" MUST BE THE SAME AS THE LAST POINT. BASICALLY THE 
"CLIPPER" CAN BE ANY OBJECT WITH A CLEARLY DEFINABLE INSIDE AND OUTSIDE 
WHETHER IT BE CONCAVE OR CONVEX, SUBJECT ONLY TO THE ABOVE RESTRICTIONS. 
SO FOR EXAMPLE, A FIGURE »8" DRAWN WITH A SINGLE BORDER IS ACCEPTABLE, 
BUT A FIGURE "8" DRAWN WITH A DOUBLE BORDER IS "BAD NEWS". THE OUTLINE 
OF A STAR IS ALSO ACCEPTABLE. HOWEVER, IF A LINE SEGMENT OF THE 
"CLIPEE" EXACTLY COINCIDES WITH A LINE SEGEMENT OF THE "CLIPPER", IT 
WILL BE EXCLUDED OR INCLUDED IN THE THE "CLIPPED" PICTURE DEPENDING ON 
THE JUDGEMENT OF THE MOON AND STARS, ASSUMING THAT THE CORRECT 
ATMOSPHERIC CURRENTS ARE PREVAILING. 

NOTE: THAT THE THE ORGINAL PICTURE IS LEFT UNMOLESTED. AND THAT THERE 
ARE NO RESTRICTIONS WHATSOEVER THE CLIPEE 


♦-NOTE: AT THIS POINT IN TIME THERE EXISTS AN IMPLEMENTATION 

RESTRICTION IN THAT THE CLIPPER MAY NOT CONTAIN MORE THAT 

100 POINTS. THE REST OF THE BIG CLIPPER'S POINTS WILL BE IGNORED 

SWITCHES: /R - FOP REVERSE CLIPPING 

THE CLIPPED PICTURE WILL CONTAIN ONLY THE LINES 
AND PCRTIONS OF LINES LEFT OUT IN ORDINARY 
CLIPPING. NOTE THAT IF THE CLIPPER DOES NOT 
FOLLOW THE ABOVE-MENTIONED RULES. CERTAIN 
ANOMALOUS LINES WILL BE LEFT CUT IN BOTH TYPES 
OF CLIPPING. 

// *************************** #**##**#**#******#*♦************* COMPIL 

COMPILE 

SYNTAX: COMPILE MNAME,BNAME 

OR COMPILE MNAME 

COMPILE TRANSLATES MACROS INTO EXECUTABLE BINARY MACHINE 

INSTRUCTIONS, AND IS USED TO INCREASE THE EXECUTION SPEEO OF A MACRO. 

MNAME IS ANY MACRO AND IT IS CALLED INTO CORE AUTOMATICALLY IF 
NECESSARY. BNAME IS THE NAME OF THE .CPL FILE GENERATED AND 
IT CONTAINS THIS BINARY MACHINE CODE. IF BNAME IS NOT SPECIFIED, 

THE .CPL FILE IS NAMED THE SAME AS MNAME (MNAME THE MACRO 
IS AUTO-DELETED IN ANY CASE). 

BNAME CAN BE SAVED BY USING: PUTDSK BNAME.CPL 

(THE .CPL MAY BE OMITTED, PUTDSK IS SMARTER THESE DAYS.) 

TO PUN .CPL FILES THE EXECUTE COMMAND CAN BE USED. 

NOTE: DON'T TPY TO TYPE OR PRINT .CPL FILES, THEY ARE NOT IN THE 

SAME FORMAT AS OTHER FILES. 

THE ONLY COMMANDS FULLY COMPILABLE ARE ARITHMETIC ONES, 

GETPOI , PUTPOI, ZAPPOI , SKIP, FLOATING POINT STUFF, AND IF. 

NOTE: ALL COMMANDS CAN BE COMPILED. ALL COMMANDS NOT LISTED ABOVE 
ARE NOT CONVERTED INTO TRUE MACHINE INSTRUCTIONS, SO COMPILING DOES 
SPEED UP PROCESSING MUCH. 


EXAMPLE i: GLOB:<A=A+iJSKIP 0> 

COMPILE GLOB,TEST 
PUTDSK TEST.CPL 
EXECUTE TEST 

EXAMPLE 2: COMPILE GLOB 

PUTDSK GLOB.CPL 

// ♦♦$***♦**♦♦#♦**♦**♦♦*♦* *#♦♦♦*♦♦#***♦#♦♦****** ******♦♦♦♦♦♦♦♦♦♦♦♦* COPY 

COPY 

SYNTAX: COPY PIXI.PIX2 

COPY CAUSES PIX 2 (THE NEW NAME) TO SHAPE THE DATA OF PIX1 
(THE OLD NAME). ANY COMMAND THAT DOES NOT MODIFY DATA LISTS (E.G. 

ROTATE, SCALE, MOVE, ETC.) MAY BE THEN INDEPENDENTLY BE USED ON EITHEP 
PIX. COMMANDS THAT ALTER DATA LISTS (E.G. SMOOTH, SOFTROT) WILL 
MODIFY BOTH COPIES. COPY MAY BE USED TO REFLECT A PICTURE AROUND 
AN AXIS BY USING THE SINGLE DIMENSIONAL SCALE. 

A SURE WAY TO CRASH THE SYSTEM IS TO DELETE THE FIRST PICTURE 
(PIX1) BEFORE DELETING THE COPY (PIX2)—SO DON'T DO IT. 

WE NOW HAVE NEW SWITCHES FOR COPY, SOME OF WHICH ACTUALLY 
COPY THE VECTORS TOO. SO, IN THESE CASES (SEE SWITCHES BELCW), ALL 
THE WARNINGS ABOUT DELETING THE FIRST PIX AND SOFT AND SMOOTH, 

ETC. DO NOT APPLY. 




/ T 


mo t cc 1 Tver rnov out At cn /-noTcc At 1 


t ucr 



/p 

/V 


PUTLIB^S THE COPY 

COPIES THE VECTORS TOO {BUT NOT THE 
TRANSFOR MATICNS 
/A LIKE /V/T 

/Q LIKE /V/P 

THERE ISN*T ANY /T/P (DO YOU WANT IT??) 

EXAMPLE: COPY GLOBE,WORLD 

ROTATE GLOBE,X,DO,DI,02 
ROTATE WORLD,Z,D9 
SCALE WORLD,D6 

THE ABOVE SHOW INDEPENDENT MOVEMENT OF COPIES 
COPY/V SAM,TOM 
SC TOM,0 
SOFT TOM 
PUTD TOM 

THE ABOVE PUTS A HALF-SIZED VERSION OF SAM ON THE 
DISK UNDER THE NAME TOM 

// ************************* *****************************************0PUNCH 

CRUNCH ESOTERIC///// 

SYNTAX: CRUNCH CPLNAME ,PNAME,EXPRl ,EXPR2,XVAR,YVAR ,ZVAR 

CRUNCH IS AN AUTOMATIC GETPOI/ZAPPCI COMBINATION, IT EXPECTS 
A COMPILED MACRO AS ITS FIRST ARGUMENT WHICH IS SUPPOSED TO AFFECT 
IN SOME WAY THF XVAR, YVAR AND ZVAR SPECIFIED BETWEEN THE 
POINT RANGE EXPPI TO AND INCLUDING EXPR2. 

example: foo:<x=x*2 

Y = Y#3 
Z=X+Y> 

COMPILE FOO 

CRUNCH FOO,CIRC9,5,100,X»Y,Z 
THE ABOVE WILL DO THE SAME AS: 

N=4 
N = N+ 1 

GETPOI CIRC9,N,X,Y,Z,K 
ZAPP CIRC9.N ,X*2 ,Y*3 ,X+Y ,K 
IF N LT 100,SKIP -3 

EXCEPT THAT CRUNCH IS MUCH MUCH FASTER AND TAKES INTO ACCOUNT 
CASES WHEN EXPR2 IS GREATER THAN THE NUMBER OF POINTS. 

TO APPLY THE CPLNAME TO ALL THE POINTS, SPECIFY 9999 AS EXPR2. 

THE CPLNAME CAN, OF COURSE, BE STORED ON THE DISK; CRUNCH GETS 
IT AUTOMATICALLY, 

// ****************************************************************** CORE 

CORE 

syntax: core 

OR CORE,VAR I,VAR2 

CORE PRINTS OUT THE TOTAL NUMBER OF FREE WORDS OF CORE 
AVAILABLE AND ALSO PRINTS THF SIZE OF THE FRAGMENT'S. IF VAP1 
IS SPECIFIED IT GETS THE TOTAL NUMBER OF FREE WORDS. IF VAR1 AND VAR 2 
APE SPECIFIED VAR1 GETS THE TOTAL NUMBER OF FREE WORDS AND VAR2 GETS THE 
SIZE OF LARGEST FRAGMENT. 


// ********************************************************************* 

/* 

THERE IS NO DESCRIPTION AVAILABLE FOR THIS COMMAND AT THIS TIME, OR 

COMMAND HAS BEEN MISSPELLED. -SORPY. 

// ******* ** ************************************************ ** ********* 

// ****************************************************************** DASHE 

DASHES 


syntax: 


DASHES 

switches: 


none 

/R 


DASHES PIX 

CHANGES THE PIX'S VECTORS TO DASH MODE. 
DASHES MODE 

DOTS MODE (REALLY SHORT DASHES) 


examples: 

DASHES LAMP 
DASHES/R DIAMON 

// ********* ********** ** *********************************** ********** DELE T 

DELETE 


syntax: 


DELETE ANAME 


DELETES THE ANAME FROM CORE, REMOVES THE NAME AND RECLAIMS THE 
STORAGE THE ANAME TOOK. 

sw itches: 

NONE AS ABOVE 

/D DELETES ON YOUR DISK AREA (REQUIRES EXTENT ION). 



✓ V- 


duetto'" use "of KEEP COMMAND~OF "Tc"* ing during"" 

EXECUTION. 

examples: 

DELETE GLOBE 
DELETE JS DR AW 
DELETE/D WITCH.DEC 

// *************************** ******** ******************************* DELPHI 

DELPOT 

syntax: delpoi 

OR DELPOI EXP P 

DELPOT DELETES THE LAST PREVIOUSLY PUT POINT IN AN OPEN•ED 
PICTURE. THE NAME OF THE PICTURE IS AUTOMATICALLY ASSUMED TO BE 
THE LAST PICTURED OPEN*ED. 

IF AN EXPR IS INDICATED, THAT NUMBER OF POINTS IS EACKED UP. 

example: 

<PUTPQI D0/16»D1/16»D2/16* 0 
IF FS I = 1 * DELPOI 
SKIP —2> 

THIS CAUSES VECTORS TO BE DRAWN FROM THE POSITIONS OF 
DIALS 0,1, AND 2 UNLESS FS 1 IS BEING HELD DOWN, IN WHICH CASE, A 
RUBBER-BAND EFFECT IS ACHIEVED. 

example: delp 5 

.THIS WILL DELETE THE LAST FIVE POINTS IN AN OPEN 1 D LIST. 

// * ******** ****************** ******************** ******************* DIRCOR 

DIRCORE 

SYNTAX: DIRCORE 

DIRC GIVES THE USER A MAP OF WHAT'S GOING ON IN USER MEMORY. 

PICTURES, MACROS, .CPL'S, ARRAYS AND SO ON ARE LISTED WITH NOTES 

ON HOW MUCH SPACE THEY TAKE UP. THE TRANSFORMATIONS THAT ARE CURRENTLY 

ATTACHED TC« PICTURES APE ALSO LISTED. 

// * **** ********* ********************* **************************** *** dirdsk 

DIRDSK 

SYNTAX: DIRDSK (OPTIONAL NAME) (OPTIONAL AREA) 

DIRDSK GIVES A LIST OF STUFF THAT'S STORED ON THE DISK. 

THE OPTIONAL NAME (SEE EXAMPLES) ALLOWS ONE TO LOOK AT PART OF THE 
DIRECTORY. COMBINED WITH THE FEATURE, ONE CAN 

SELECT PATTERNS OF AREAS OR NAMES. 

IE THE OPTIONAL AREA IS SPECIFIED, IT MUST BE A VALID 
LOGIN AREA ON THE DISK. 

switches: 

/L DIRECTORY IS LISTED ON THE LINE PRINTER 

INSTEAD OF THE VT05. 

EXAMPLES: DI GIVES YOU A LOOK AT YOUR DISK DIRECTORY 

DIRDSK ♦.DEC 1,1 LISTS ALL NAMES WITH A .DEC 
EXTENSION IN AREA 1,1 

DIRDSK S*.* LISTS ALL NAMES BEGINNING WITH S 
DIRDSK P*.M* LISTS ALL NAMES BEGINNING WITH P 
AND EXTENSIONS BEGINNING WITH M 

// ******************************* *********************************** DI RT AP 

DIRTAPF 

SYNTAX: DIRTAPE (OPTIONAL NAME) (OPTIONAL AREA) 

DIPTAPE GIVES A DIRECTORY LISTING OF A DECTAPE ON THE VT05 
SCREEN. THIS HAS THE FEATURE SAME AS THE DIRDSK COMMAND. 

DEFAULT AREA IS THE USERS OWN TAPE AREA. BE SURE WHEN USING THIS 
COMMAND THAT THE DECTAPE IS ON REMOTE AND SET FOR UNIT 0. 

EXAMPLES: 

DIRT APE 

THIS GIVES A DIRECTORY LISTING OF 
EVERYTHING ON THE USERS TAPE AREA. 

DIRTAPE *.DEC 1,1 

THIS GIVES A DIRECTORY LISTING OF 
OF ALL FILES WITH A .DEC EXTENSION 
IN TAPE AREA 1,1. 

// ******************* ** ****** ** ** ************** ******** ************* do 

DO 

SYNTAX: DO MNAME 

OR DO MNAME.MAC XX,XX 

OR DO MNAME,APGI.ARG2,. 


DO IS USED FOR EXECUTING DISK- OR CORE-RESIDENT MACROS. 
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AS OPERANDS TO THE RESTART COMMAND AND ISSUED WITHIN 0 T HER 
MACROS IF DESIRED. ARGUMENTS MAY BE PASSED TO THE MACRO BY THE 

USE OF ARG1.APG2. (READ BY THE INPUT COMMANDS INSIDE THE MACRO). 

IF ANOTHFR MACRO IS CALLED THE OLD ARGUMENTS ARE LOST. 

EXAMPLES: DO FLUFF 

DO FLUFF.MAC 30,4 

DO FLUFF.VIAC 31,3 (SAME AS "CALL FLUFF") 

DO FLUFF,10,22,SAM.DEC 

(10 IS PASSED TO FIRST INPUT 
22 IS PASSED TO SECOND INPUT 
THE STRING SAM.DEC IS PASSED TO 
THE THIRD INPUT COMMAND, ANY 
FURTHER INPUTS WILL GO TO THE 
KEYBOARD.) 

NOTE THAT PROMPTS ARE SUPPRESSED 
UNTIL THE ARGS RUN OUT. 

// ****************************************************************** DCLOOF 

DOLOOP 

SYNTAX: DOLOOP MNAME 1,MNAME2,.•.• ESOTERIC//// 

OR DOLOOP MNAME 

OR DOLOOP <.... 

• • • 

. . .> 

DOLOOP IS AN ALTERNATIVE TO 'DO' AND IT RUNS THE MACRO 
(OR .CPL) AS A BACKROUND JOB. WHEN USING DOLOOP, ALL MACROS 
SHOULD BE DOLOOPED SINCE 4—LEVEL & NORMAL MACRO LEVEL HAVE 
PRIORITY. THINGS REQUIRING INPUT FROM THE TERMINAL IN A DCLOCP'ED 
MACRO WILL STOP ALL MACROS, AS WILL SWAP MODULES WHILE THEY ARE 
SWAPPING IN. DOLOOPED MACROS MAY HAVE SKIPS. BUT A SKIP AT THE END 
BACK TO T HE BEGINNING IS ASSUMED. TICK WILL WORK INDIVIDUALLY FOR 
EACH MACRO. LOCAL VARIABLES SHOULD BE USED WHENEVER POSSIBLE. 

AT LEAST BE VFRY CAREFUL WHEN USING VARIABLES WITH DCLOOPING SC 

YOU DON'T HAVE TWO MACROS CHANGING THE SAME VARIABLE UNINTENTIONALLY. 

DOLOOPED MACROS ARE EASILY STOPPED BY jC. 

SWITCHES: DOLOOP/E MNAME,EXPR 

DOES THE MACRO EXPR NUMBER OF TIMES 
DOLOOP/V MNAME,VAR 

DOES THE MACRO UNTIL #0F TIMES = VAR 

EXAMPLES: DOLOOP <D=D+D5/32> 

DOLOOP SAM,FIRED,COMPACT 

NAMED DOLOOPED MACROS MAY BE INDIVIDUALLY CANCELLED BY UNLCOP. 

// * TT* * **************** ****** ************ ************** ********* 

/* 

THERE IS NO DESCRIPTION FOR THIS COMMAND AT THIS TIME, OR 

COMMAND HAS BEEN MISSPELLED. -SORRY. 

// ******************************************************************** 

// * ********** ******** ** ****** ************ ***************** ********** EXEC Uf 

EXECUTE 

SYNTAX: EXECUTE BNAME ESOTERIC///// 

OR EXECUTE BNAME,ARG1,ARG2, ...... . 

EXECUTE IS TO .CPL (COMPILED) MACROS WHAT "DO" IS TO 
NORMAL MACROS. THE COMPILED MACRO IS GOTTEN FROM THE DISK (YOUR AREA 
UNLESS SPECIFIED IN. XX,YY LOGIN CONVENTIONS) UNLESS IT'S ALREADY 
IN CORE, AND THEN THE COMPILED MACRO IS RUN. THERE IS NO 
EQUIVALENT TO GOTO FOR COMPILED MACROS, BY THE WAY. 

1C AND |S CAN STOP EXECUTION OF COMPILED MACROS. 

// ♦*A*♦**♦♦****♦* *4** ******** *******************************pdIT 

EDIT 

SYNTAX: EDIT MNAME 

EDIT IS AN IN-CORE QUICKY EDITOR WHICH WORKS ONLY CN MACROS. 

IT IS FAST, SMALL, AND HAS THE ADVANTAGE THAT YOU DO NOT HAVE TO RESTART 
GRASS FACH TIME YOU WANT TO USE IT. MOREOVER, IT CAN BE ENTERED AND 
RE-ENTERED VERY QUICKLY. 

IT'S MAJOR DISADVANTAGE IS THAT IT DOES NOT DO EVERYTHING 
THAT CALL EDIT DOES. FOR INSTANCE, YOU TYPE |C TO GET OUT OF THIS 
EDIT, AND THE MACRO IS UPDATED ONLY IN CORE, AND NOT ON THE DISK. 

FOR THIS REASON, WE HAVE IMPLEMENTED A NEW PUTDSK SWITCH-PUTDSK/D— 

WHICH PUTS THE FILE ON THE DISK, FIRST CREATING A BACKUP 
(.BAK) IF THE FILE ALREADY EXISTS ON DISK. THEREFORE, AS SOON AS 
YOU HAVE A WORKING VERSION OF A MACRO, PUTDSK/D IT OR YOU WILL LOSE 
IT UPON RESTART. ONE MORE THING: THIS EDIT WILL NOT CREATE WACRCS, 

IT WILL ONLY WORK ON MACROS THAT EXIST ON DISK OR IN CORE ALREADY. 

EDIT WILL FETCH A MACRO FROM THE DISK IF IT IS NOT ALREADY 
IN CORE, BY THE WAY. 




TO TYPE LINE 100 
TO TYPE LINES 50 TO 200 
TO DELETE LINE 20 

TO CHANGE AAA TO JHKL IN LINE 80 


TO CHANGE ALL OF LINE 400 
TO INSERT AFTER LINE 30 
TO EXIT FROM EDIT 


OR 


10 0<CR> 

50 »200<CR> 

20—<CR> 

80/A A A/J HKL/<CR> 

80 AAA JHKL <CR> 

400 THIS IS NEW LINE 400<CR> 
31 THIS IS A NEW LINE<CR> 

|C 


SOME notes: 


THIS EDIT RENUMBERS THE LINES AFTER 
DELETE. THIS MEANS THAT YOU SHOULD 


EACH INSERT OR 
LIST THE LINES YOU WANT 
TO PLAY WITH AFTER EACH INSERT OR DELETE BECAUSE THE LINE NUMBERS 
WILL SHIFT. HOWEVER. YOU CAN MULTIPLY DELETE LINES 
20 THRU 40 BY TYPING "20-<CR>" THRFE TIMES (TRY IT). 

YOU CAN ALSO MULTIPLY INSERT AFTER LINE 20 BY TYPING: 

21 THIS IS LINE AFTER 20 
31 THIS IS THE NEXT LINE 
41 THIS IS THE NEXT LINE 


ETC 


THIS MAY LOOK WEIRD BUT IT‘S EASY TO GET USED TO, 


2. LOCAL VARIABLE TABLES ARE ZEROED BY THIS EDITOR. OTHERWISE. IT 
IS POSSIBLE TO EDIT MACROS OVER AND OVER AGAIN WITHOUT 
RESTARTING, WITH NO SIDE EFFECTS. 

3. IF YOU ARE TIGHT ON SPACE AFTER USING THIS EDIT, DEL/C EDIT TO 
GET RID OF IT 

// ****************************************************************** EXIT 

EX IT 


SYNTAX: EXIT 

EXIT IS SIMPLY A PROGRAMMED |C. IF YOUR MACRO SEES AN 
■•EXIT** COMMAND, THE SYSTEM RETURNS TO *— LEVEL DOING WHATEVER A |C WOULD. 

// ***** **************** ****** ************ ************ ***************** 

/* 

WE DON'T HAVE THAT ONE AROUND... . CQMPLAIN LIKE HELL 
// **************************************************************** 

// ******************* ** ** ************ ******** ************* ********* * F ILMIN 

FILMING 


SYNTAX: FILMING 

OR FILMING EXPR 

FILMING/M EXPR 


ESOTERIC///// 


FILMING IS A COMMAND WHICH ALTERS THE SPEED OF THE UPDATES 
GF ROTATIONS, MOVES, SCALES, TIME-BASED VARIABLES, DIAL 
READINGS, VIP'ED CPL'S, ETC. FILM (WITHOUT ANY EXPR) STOPS 
UPDATES AND WILL CONTINUE ONLY WHILE FS1 IS HELD DCWN. 

"FILM FXPR” CAUSES THE UPDATES TO BE DONE WITH 

TIME DELAYS EQUAL TO THE NUMBER OF TICKS SPECIFIED BY THE EXPR. 

SO FILM 2 WILL UPDATE EVERY OTHER 1/60 SEC (30 TIMES A SECCND) 

AND FILM 60 WILL UPDATE ONCE A SECOND. THIS COMMAND FEATURE IS 
USEFUL TO CAUSE MOTIONS TO APPEAR TO STEP, OR, IS OCCASIONALLY 
USEFUL IF TOO MUCH BLENDING, POTATIONS ON GROUPS, ETC., 

CAUSE THINGS LIKE DIRCOR OR PUTDSK TO OPERATE TOO SLOWLY. 


FILM/M EXPR IS USED TO TRIGGER THE MOVIE CAMERA SITTING 
ON TOP OF THE SCOPE. YOU SHOULD TALK TO TOM ABOUT USING THE 
CAMERA SINCE IT IS A PRIMITIVE, SILVER-EATING THING 
WHICH IS NOT REAL-TIME IN OPERATION. FILM/M DOES A 
PRETTY GOOD JOB OF SLOWING DOWN PROPERLY WRITTEN MACROS 
SO IMAGES RECORD WELL ON FILM. 


examples: film 

FILM/M 100 

// *********************** ******************************************* FIX 

FIX 

syntax: fix pname 


FIX FRFEZES THE POSITION 
MODIFIER ACCORDING TO THE SWITCH 
FIX ALSO REMOVES DEV ASSIGNMENTS 


OF A PICTURE 
OPTIONS. NO 
IF ANY. 


OR THE VALUE 
SWITCH FIXES 


OF A PNAME* S 
EVERYTHING. 


SWITCHES: 


NONE 

FIXES 

/P 

FIXES 

/S 

FIXES 

/M 

FIXES 

/P 

FIXES 

/I 

FIXES 

/Q 

FIXES 

/C 

F I XES 

/O 

FIXES 


ALL OF THE BELOW 

POTATION 

SCALE 

MOVE 

PATHMOV 

INTENSITY 

Z-AXIS CUEING (SETCQ) 
CUTOFF PLANES 
SETORG 


/ / * **** **************** * * ** *+#4:** 4*4:* **»*t****4*4***44* ******* ****** F S OF F 

FSOFF 


SYNTAX : 


FSOFF EXPR1,EXPR2,EXPR3, ETC. 


FSOFF TURNS OFF THE FUNCTION SWITCHES CORRESPONDING TO THE 
EXPRESSIONS. FSOFF ALONE TURNS OFF ALL THE SWITCHES. 

WHEN A FUNCTION SWITCH IS TURNED OFF, ITS VALUE IS 0. 

EXAMPLE: FSOFF 1,3,5,7,9,11,13,15 

THIS TURNS OFF THE ODD FUNCTION SWITCHES. 

FSOFF 

THIS TURNS OFF ALL THE SWITCHES. 

// *************************************** *************************** F SON 

FSON 

SYNTAX! FSON EXPR1 ,EXPR2,EXPR3.. .. 

FSON TURNS ON (SETS TO ONE) FUNCTION SWITCHES CORRESPONDING 
TO EXPR1 ,EXPR2 , ETC. FSON DOES NOT WORK WITH THE PANIC BUTTON. 

EXAMPLE: FSON 0,2,4,6,8,10,12,14 

THIS LIGHTS UP THE EVEN SWITCHES AND SETS THEM TO EQUAL 1. 

// * ****************** ** ** ** **** ****** ************************** ******** 

/* 

SOMETHING IS WRONG HERE, WE DON* T SEEM TO HAVE THE HELP ON THE COMMAND 
THAT YOU TYPED IN. HMMMMMMM, YOU SURE YOU DIDN'T SPELL THE NAME 
WRONG?????? 

// ******************************************************************** 

// ♦************* ********* *** ********* ** ** ** ************************* ge td sk 

GETDSK 


SYNTAX: GETDSK DNAME.EXT XX,XX 

OR GETDSK DNAME.EXT XX,XX ,EXPR1♦EXPR2,VAR 

GETDSK GETS THE DNAME FROM THE DISK AREA INDICATED BY •• XX,XX ** 
(DEFAULT IS YOUR AREA). IF NO .EXT, IT DEFAULTS TO .DEC. 

DNAME BECOMES THE NAME OF THE THING YOU ARE GE TD SK•ING. IF EXPR'S ARE 
GIVEN, THEY GET LINES STARTING AT LINE EXPR1 UP TO AND INCLUDING 
LINE EXPR2 IN THE FILE. IT RETURNS A VALUE OF IN VAR IF THERE IS MORE 
AND A VALUE OF l IF END OF FILE. GETDSK WITH EXPR'S IS ESOTERIC///// 

EXTENSIONS: 

•DFC STANDARD PICTURE MODE (DEFAULT) 

• CPL COMPLD FORMAT (FOP BINARY CODE. DON'T TYPE OR 

PRINT THESE FILES, WEIRD THINGS 
HAPPFN.) 

.MAC MACRO FORMAT (FOR MACROS, NOT FOR PICTURES) 

NOTE THAT .DEC TYPE PICTURES COME UP ON THE SCREEN. 

SWITCHES: /P (FOR .DEC ONLY) PICTURE IS PUTLIB'D 

FIRST. WITH THIS SWITCH, ONE 

CAN GET A PICTURE, ROTATE IT, ETC., 

AND THEN GFTL/W IT SO IT WILL APPEAR 
IN THE RIGHT PLACE WHEN FIRST SEEN BY 
WHOEVER IS IN FRONT OF THE VG. 

/M - IGNORES E XT ENT I ON CHECKING AND GETS 

THE FILE AS IF IT WERE A MACRO.IT ALSC 
ALLOWS REMARKS TO BE LEFT IN THE MACRO. 

THIS IS USEFUL FOR HANDLING .DEC FILES IN 
ASCI I . 

NOTE: GETDSK NORMALLY STRIPS OFF ALL LINES BEGINNING 
WITH THE CHARACTER •*» IN .MAC FILES, SO 

COMMENTS MAY BE LIBERALLY PROVIDED IN YOUR MACRO WITHOUT 
WORRYING THAT THE MACRO WILL TAKE UP TOO MUCH SPACE. 


EXAMPLES: 


GETDSK WITCH 
GETDSK WITCH. OEC 
GETDSK WITCH.DEC 30,10 
GFTDSK DRAW.MAC 
G CALCUL.CPL 

G FORD.ARA,AH (PUTS FORD•ARA INTO ARRAY AH 

NO DIMENSIONING NECESSARY. 

NOTE THAT THE ARRAY COMMANO 
IS ONLY FOR SETTING UP NEW ARRAYS. 


G/P BLO 8 
POT BLOB,Y,DO 
SC BLOB,15000 
MOV BLCB.TX 

GETL/W BLOB AUTO-PUTLIB FEATURE 

USED INTELLIGENTLY. 

// * ******** ********** ** ** ** ** ******** ********** ********************* GETHIt 

GETHIT 



gethit returns the status of a lightpen hit where n gets the 

NUMBER OF THE POINT IN PIX, X,Y,Z GET THE RESPECTIVE COORDINATES, 

AND K TS SET TO ZERO IF IT IS A DRAWN POINT, ONE IF IT IS THE INITIAL 
POINT OF A DRAWN VECTOR {I.E.EQLL0WING A JUMP), AND MINUS CNE IF IT IS 
THE LAST POINT IN THE PIX. 

example: gethit panam,f,u,c,k,q 

(AN EXAMPLE IN THE HUMOR STYLE OF MAINE EAST.) 

// ******* *********** * ************** ********************** *********** GETLIP 

GETLIB 

SYNTAX: GETLIB PNAME ESOTERIC///// 

OR GETLIB PNAME,PNAME2 

GETLIB RETRIEVES THE PNAME FROM THE NON-DISPLAYED IN-CORE 
PICTURE LIST AND DISPLAYS IT. IF PNAME2 IS INDICATED, 

IT IS PUT IN THE TREE AFTER PNAME1 (SEE HELP TREE, HELP GRCUP). 

IF PNAME2 IS NOT SPECIFIED, PNAME BECOMES THE FIRST ELEMENT 
TREE. 

NOTE THAT PNAME2 MUST BE DISPLAYED AND'PNAME MUST HAVE BEEN 
PUTLIB'ED AT SOME TIME (BY PUTLIB OR GET DSK/P OR CCPY/P). 

GETLIB AND PUTLIB ARE THE ONLY WAY TO MOVF THINGS AROUND IN THE 
TREE STRUCTURE. 

EXAMPLES: GETLIB SAM 

GETLIB MARY,SAM 

// * ****** **** *** * ****** ********** **** ************ ******************* GETP0 I 

GETPOT N 


syntax: getpoin pix,n,x,y,z,k 

WHERE N IS AN EXPR AND X,Y,Z,K ARE VARS 


GETPOIN GETS A POINT FROM AN LNAME. THE X,Y,Z COORDINATES 
OF THE NTH POINT ARE RETURNED IN VARIABLES 

INDICATED HERE BY X,Y,Z. N RANGES FROM THE 1 (THE FIRST POINT) TO 
THE LAST POINT IN THE LNAME (WHICH DEPENDS ON HOW BIG THE PICTURE IS). 
K IS A VARIABLE IN WHICH THE FOLLOWING IS INDICATED: 


K = 0 
K=l 


K=-l 

SWITCHES: 


DRAWN VECTOR 

NON-DRAWN VECTOR (JUMP) THAT IS, NO LINE DRAWN 

TO THIS POINT FROM THE 
LAST POINT. 

END OF LIST (LAST VECTOR) 

/N - GETS POINTS SEQUENTIALLY FROM A 

PICTURE. ONCE GETPOIN IS EXECUTEO, 

THEN /N GETS NEXT POINT(S) & USES 
THE SAME VARIABLES. THIS HAS NO 
ARGUMENTS. IT ALSO SPEEDS UP 
PROCESSING GREATLY 


EXAMPLE: 


GETPOIN WITCH,20,G ,H,I,K 
THIS WILL GET THE COORDINATES IN DECIMAL 
VECTOR IN WITCH ANO PLACE THEM IN VARIABLES G, H, I 
WHETHER THIS LINE WAS DRAWN, A JUMP OR THE END OF 
VARIABLE K. 

THE APPLICATION FOR THE SWITCH IS: 

<N=0 


OF THE TWENTIETH 
ANO INDICATE 
THE LIST, IN 


N=Nt 1 

GETPOIN EL,N,X,Y«Z 
SK —2> 

THIS MACRO WILL GET ALL THE POINTS IN THE PIX CALLED FL, BUT IT CAN 
BE DONE FASTEP WITH THIS MACRO: 

< GEPOIN FL »N,X,Y,Z 
GETPOIN/N 
SK -1> 

IN BOTH CASES, THE MACRO WILL GIVE AN ERROR MESSAGE AT THE END OF 
THE PIX LIST. THE SECOND WILL EXECUTE MUCH EASTER SINCE IT ALREADY 
KNOWS WHICH VARIABLES TO USE. GETP/N DOES NOT WORK WELL WITH 
DOLOORING, THOUGH. 


A WAY TO GET TO THE END WITHOUT GETTING AN ERROR MESSAGE, BY THE WAY, 

is: 

<N = 0 
N=N+i 

GETP PIX,N,X»Y,Z»K 
IF K#~l,SK -2 

PROM "PIX HAS ”,N," VECTORS"> 

// ****************************************************************** GCTO 

GOTO 


syntax: goto MNAME+EXPRESSION ESOTERIC///// 

GOTO IS USED TO TRANSFER CONTROL TO A MACRO WHEN YOU 

a mt t o r>cr tiiOm *r*r-» rur *r u a t- ~r 


Kir \/rn 




DON'T DO IT UNLESS YOU REALLY HAVE TO. 

// * *** *************** ******** ******** ************ **** **** * * ********* GROUP 

GROUP 

SYNTAX: GROUP PNAME1.PNAME2,GNAME 

GROUPS PNAME 1 » PNAMF2 AND EVERYTHING BETWEEN THEM INTO A GROUP 
NAMED GNAME. PNAMES MUST BE DISPLAYED. PUTLIB/GETLIB SEQUENCES MAY 
BE USED TO ALTER GROUP STRUCTURE BY ELIMINATING OR ADDING PICTURES IF 
NECESSARY. ANY COMMAND WHICH WILL WORK ON PNAMES WILL WORK ON 
GROUPED PICTURES (EXECPT DELETE). CHECK "TREE" BEFORE GROUPING 
TO MAKE SURE THE PNAMFS ARE ON THE SAME LEVEL & THE RIGHT STUFF 
IS GROUPED. 

GROUP WORKS WITH BLANK'D PIX TOO. 

THE COMMANDS WHICH WORK WITH GROUPS ARE: 

GROUP CUTOFF FIX GETLIB MOVE PATHMOV PUTL IB RESET 

ROTATE SCALE SET CQ SETINT SETORG 

WITH GETLIB AND PUTLIB, YOU CAN MOVE PIX & GROUPS AROUND 
IN THE TREE DATA STRUCTURE. 

FOR EXAMPLE, IN 

GETD PLANE 
GETD PROP 

GROUP PROP » PLANE »SAM 
THE TREE LOOKS LIKE: 

SAM 

PROP 

PLANE 

NOW A PUTLIB PROP WILL UN-DISPLAY IT AND TAKE IT OUT OF THE 
GROUP SAM. A GETLIB PROP WILL RE-DISPLAY IT BUT IT WILL NOT BE 
IN SAM. TO GET IT BACK IN SAM, YOU HAVE TO GETLIB PROP,PLANE. 

FURTHERMORE, 

GETD/P WHEELS 
GETL/W WHEELS,PLANE 

WILL GET WHEFLS UNDER SAM WITHOUT ANY UNSIGHTLY FLASHING (DUE TO THE 
GETL/W WHICH WAITS FOR THE TRANSFORMATIONS TO TAKE EFFECT BEFORE 
DISPLAYING) . 

// ***** ********** ****** ****************** **************************** 

/* 

GEE WHIZ, WHAT CAN I SAY EXCEPT THAT THERE ISN'T ANY INFO ON THE 
COMMAND THAT YOU TYPED IN, MAKE SURE THAT YOU SPELLED IT RIGHT. 

TRY IT AGAIN. 

// ********************* ** ** ** **** ** ** ************ ******** **************** 

// ****************************************************************** hflp 

HELP 


SYNTAX: 


HELP COMMAND-NAME 


AID 


HELP IS HERE TO ANSWER SYNTAX QUESTIONS. 
CERTAIN ABBREVIATIONS HAVE BEEN USED WHICH 
UNDERSTANDING: 


WILL, HCPEFULLY, 


ANAME IS ANY PICTURE OR MACRO NAME 
PNAME IS ANY PICTURE NAME (GROUP OR 
PIX IS ANY SINGLE PICTURE 

GNAME IS ANY GROUP NAME 
MNAME IS ANY MACRO NAME 
DNAME IS ANY DISK FILE NAME 
ARRNAME IS ANY ARRAY NAME 

CPLNAME IS ANY COMPILED MACRO IN BINARY 
<CR> IS THE.SYMBOL FOR CARRIAGE RETURN, 
TO END LINES YOU TYPE ON THIS TERMINAL. 


SINGLE PICTURE) 


FORM 
THE KEY 


YOU MUST PUSH 


NAMES IN CORE MAY BE ABBREVIATED TO ENOUGH LETTERS TO INSURE UNIQUENESS 


>>>»>>>DE V 


IS ONE OF THE 
DIALS 0-9 
SLIOE POTS 
TEN TURN POTS 
TABLET 
JOYSTICKS 
VARIABLES 


FOLLOWING 
(00-09) 

(SO - S9) 

(PO - P3 ) 

(TX, TY AND TZ) 
(JX,JY,JZ) AND 
( A-Z) 

(VA -VZ) 

(WA - WZ) 

(FA - FZ) 
(SA-SH) 

(C A-CH) 

(LA-LZ ) 

(EA-EZ) 

( OA-OH ) 

PLUS THE 


ANALOG DEVICES OR VARIABLES 


(KX.KY.KZ) 


SINE VARS 
COSINE VARS 
LOCAL FIXED 
LOCAL FLOATING VARS 
ANALOG OUTS 
TIME-BASED VARIABLES 


VARS 


SEE HELP DEV FOR HOW TO USE VARIABLES. 


>>>>>>>VAR 


IS A DEV 
CUTLINFO 


THAT DOES NOT 
IN HFLP DEV. 


OBEY 

VARS 


DEVICE CONVENTIONS AS 
ARE USED WHEN 


n> r y i irjM 


ia nt a a * 



>>>>>>>EXPR 


Cj r*. i nc_ v, inu t o r w i » unvuvn i » w *-% v, »w *»-.*" 4 

FULL-BLOWN DEV'S FOR SOME REASON. 

IS A MIX OF NUMBERS,DEVS AND ARITHMETIC OPERATORS WHICH 
ALWAYS EVALUATES TO A SINGLE NUMBER. 

THE OPERATORS APE + ,-,*,/. 

examples: a 

D7 
200 

A+(D7/200)*35-B-(K/17) 

THERE IS OPERATOR PRECEDENCE WHEN EXPRESSIONS 
ARE EVALUATED I.E., EXPONENTI AT I ON IS DONE FIRST 
(ONLY FOR USE WITH FLOATING POINT NUMBERS), 

MULTIPLICATION AND DIVISION ARE DONE NEXT, FINALLY 
ADDITION AND SUBTRACTION ARE PREFORMED. 

PARENTHESIS CAN BE INSERTED AROUND PARTS OF AN 
EXPRESSION SO THAT DESIRED OPERATIONS WILL BE 
PERFORMED FIRST. THUS THE FOLLOWING EXPRESSION 
(52 +8)/2 + 12 EQUALS 42. 

THERE ISA MOD FUNCTION SO 10%4 EVALUATES TO 2. 

SEE HELP FORTRAN FOR MORE DETAILS ON ARITHMETIC STATEMENTS. 

>>>>>>>$VAR IS A STRING VARIABLE AND HOLDS TEXT. 

STRING MANIPULATION IS COMPLICATED EXCEPT 
FOR THIS CASE: 

PROM "WHAT'S THE PIX NAME" 

INPUT SA 

GETDSK $ A 

ROTATE SA,X.DO.D1 

THIS EXAMPLE USES SA AS A DUMMY SO MACROS CAN BE GENERAL 
PURPOSE. SEE HELP MACROS FOR MORE DETAILS. 

DOCUMENTATION CONCERNING SYNTAX FOR A PARTICULAR COMMAND MAY 
BE RETRIEVED BY TYPING HELP FOLLOWED BY THE COMMAND NAME: 

HELP ROTATE 

WILL GET INFORMATION ON THE ROTATE COMMAND. 

THERE ARE ALSO SYSTEM MACROS FOR MOST COMMANDS SO IF YOU DC 
NOT UNDERSTAND THE DOCUMENTATION IN HELP, A MACRO WILL STEP YOU 
THROUGH MOST COMMANDS. CALL CLIP, FOR INSTANCE, WILL 
RUN YOU THROUGH THE CLIP COMMAND. 

IF YOU GET AN ERROR, TYPE A "?" FOLLOWED BY A CARRIAGE RETURN 
(AGAIN, REFERRED TO AS <CR>). THE ERROR MESSAGE WILL BE PRINTED OUT. 

COMMANDS MARKED "(STRING MANIPULATION)" AND » ESOTERIC/////" 

ARE BEST SKIPPED BY NOVICES. 

IF THE HELP DOCUMENTATION DOES NOT MAKE SENSE, PLEASE MAKE A 

LOT OF NOISE ABOUT IT. IT'S HARD TO GUESS WHAT YOU DON'T UNDERSTAND. 

THE HELP DOCUMENTATION IS MOSTLY FOR SYNTAX QUESTION. SOME ADDITIONAL 
CLUES ON HOW TO WRITE GRASS PROGRAMS APE CONTAINED IN HELP FORTRAN, 

HELP DEV, HFLP PIX, AND HELP MACROS. 

NOTE THAT THE CNTL W BUTTON WILL HALT A HELP PRINTOUT UNTIL YOU HIT 
CNTL Q. YOU TYPE CNTRL Q AND THE OTHER CONTROL FUNCTIONS EY HOLDING 
DOWN THE CTRL BUTTON AND TYPING THE LETTER KEY. IT WORKS JUST LIKE 
A SHIFT KEY ON A TYPEWRITER. 

THE CNTL S BUTTON WILL HALT EXECUTION OF A MACRO AND PUT THE USER 
IN THE #-SIGN MODE. IN THIS MODE THE USER CAN PERFORM ANY CF THE 
SYSTEM COMMANDS. TO RETURN TO MACRO EXECUTION, TYPE 'RESUME*. 

REMEMBER TO USE THE CNTL C BUTTON IE THINGS GET OUT OF HAND, AND THAT 
THE WORST YOU CAN DO IS STALL THE COMPUTER. 

// ******************************* *********************************** 

/* 

THERE IS NO DESCRIPTION AVIALABLE FOR THIS COMMAND AT THIS TIME, OR 

COMMAND HAS BFFN MISSPELLED. -SORRY. 

// ***** ********* ************* ******** ******************************** 

// ******************* ** ************************** ******** * * ********* I f 

IF 


SYNTAX: 


OR 

OR 


IF VAR OPR EXPR,COMMAND 
IF ES0 OPR EXPR,COMMAND 
IP SVAR OPR ALPHA-EXPR,COMMAND 


IF IS THF SYSTEM'S CONDITIONAL FOR USE WITHIN MACROS. THE 
CRYPTIC SYNTAX ABOVE IS BECAUSE THE IE STATEMENT IS SO FLEXIBLE. DEV 
AND EXPR APE DEFINED IN "HELP HELP" 

OPR CAN BE EQ, NE , LE, LT, GE , GT , =, OR * (NOT EQUALS) 

FS# IS ESO - FS15 FOR FUNCTION SWITCHES (0 = OFE , 1=0N) 

SVAR IS SA - SZ 

ALPHA-EXPR IS FITHER SA-SZ OR ‘ANY STRING IN QUOTES'. IF ONE OF THE 

CHARACTERS IS A THEN ALL STRINGS MATCHING THE CHARACTERS UP TO 
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GRASS STATEMENTS. 

IF FS1=1,D0 PRETTY 

IF FS1 FQ 1,DO PRFTTY (SAME THING AGAIN) 

IF DO LT D 9/22 »A =A+900 
IF QA GT O.SK 0 

IF TX GT O.IF TY GT 0,PUTP TX.TY.0,0 
IF $A=$B.SKIP 5T 
IF $A=* YES•,SKIP %YES 
I<=• $AW»Y*‘,SKIP %NO 
IF $B=‘TIGER',FSON FSllDO TIGMAC 
IF FA+32 GT B + 10 IS ILLEGAL. YOU HAVE TO COCE IT LIKE: 

IF FA GT B + 10-32.... ONLY VARS ARE ALLOWED ON THE 

LEFT SIDE OF THE OPR. 

// * ************ ****************** **** **** ********************* ***** * INPUT 

INPUT 

SYNTAX: INPUT VAR 

OR INPUT $VAR 

INPUT IS THE COMMAND YOU USE IN A MACRO TO GET A 
RESPONSE FROM THE TELETYPE. YOU HAVE THE CHOICE OF INPUTTING 
NUMBERS INTO FIXED OR FLOATING VARIABLES. OR INPUTTING NAMES 
OR OTHER CHARACTER STRINGS INTO $VARIABLES * 

INPUT CAN BE FAIRLY ESOTERIC IN USE. FOR EXAMPLE. WHEN 
USING THE ARGUMENT FEATURE OF DO. CALL OR EXECUTE. THE 
ARGUMENTS ARE AUTOMATICALLY FED VIA THE INPUT COMMAND INTO THE 
MACRO. THIS MEANS THAT YOU CAN TEST THE MACRO INTERACTIVELY AND 
AND THEN USF IT AS PART OF ANOTHER MACRO WITHOUT REWRITING 
ANYTHING EXCEPT THE DO, CALL OR EXECUTE COMMAND LINE. 

INPUT IS NORMALLY PREFACED WITH A PROMPT SO THE USER KNOWS 
WHAT IS EXPECTED. 

INPUT/O AND INPUT/1 THROUGH INPUT/9 ARE ESOTERIC TOO. 

INPUT/O WILL GET THE LAST CHARACTER TYPED AND WILL NOT WAIT. IN THIS 
MODE, INPUT OFF THE KEYBOARD MAY BE USED LIKE FUNCTION SWITCHES. 

INPUT/1 WILL WAIT FOR ONE CHARACTER TO BE TYPED AND THEN 
GRAB CONTROL BACK WITHOUT WAITING FOR A <CR>. 

INPUT/5 WILL WATT FOR FIVE CHARACTERS, ETC. NORMAL INPUT COMMAND 
USAGE ALWAYS RESULTS IN THE SYSTEM WAITING FOR A <CR>. 

INPUT OF NUMBEPS MAY BE SEPARATED BY COMMAS IN BOTH 
THE INPUT COMMAND AND/OR THE RESPONSE. IF ENOUGH INFORMATION 
IS SUPPLIED, THE MACRO CONTINUES? OTHERWIZE THE SYSTEM WAITS. 

FOR example: 

PROMi: <PROM "ENTER THE TWO NUMBERS" 

INPUT A,B 

PROM "THE SUM IS »,A+8> 

switches: 

ALL THESE SWITCHES ARE ESOTERIC///// 

/L - TAKES ARGUMENT AS PASSED FROM DO AND THEN 
FLUSHES THE REST. (USED TO PREVENT CASE OF 
USFR PASSING TO MANY ARGUMENTS.) 

/O - INPUT VALUE IN OCTAL (BASE EIGHT) 

/T - TERMINATES INPUT FROM ARGUMENT LIST AND 
SAYS "TAKE NEXT INPUT FROM TTY AND TURN 
PROMPTS BACK ON" 

/0-/9 AS EXPLAINED ABOVE 

EXAMPLES: INPUT A - WHERE A IS A NUMERIC 

INPUT $B - WHERE $B IS A CHARACTER STRING 

INPUT-FC - WHERE FC IS A FLOATING POINT NUMBER 

*<PROMPT "WHAT PICTURE ?" 

+ INPUT $ A 
♦ROTATE $A,X,D0> 

// ********************* ******** ********** ************************ 

/ * 

YOU ARE OUT OF LUCK, THERE IS NO HELP ON THAT COMMAND. CHECK YOUR 
SPELLING, BY TRYING IT AGAIN, OK?? 

// ************* **************************************************** 

// *********************** *** ***** ************************************** 

/* 

JUMPING JOSAPHATS- THERE AIN»T NO COMMANDS THAT START WITH A "J". 

CHECK YOUR SPELLING.... 

// ******************************************************************** 

// ****************************************************************** KEEP 

KEEP 

syntax: keep command 

KEEP IS USED TO SAVE CERTAIN COMMANOS IN CORE IF YCU USE THEM 
OFTEN. NORMALLY, THE COMMAND IS BROUGHT IN FROM THE DISK AND 
EXECUTED, AND THEN DELETED. IF SUCH A COMMAND IS IN A LOOP. 


examples: 


NOTE THAT 




ONE 0F THE FOLLOWING COMMANDS, KEEP IT. AFTER 

YOU* PE DONE WITH IT, USE DELETE/C COMMAND TO GET RID OF IT IF 
YOU‘RE SHORT ON CORE. 


THE COMMANDS WHICH ARE 


ARRAY 

DIRDSK 

PUTDSK 

RENAME 

TREE 


BACKUP 

DIPCOR 

PUTTEX 

PESCLV 

TYPE 


BUMP 

DIRTAP 

PUSHVA 

SEARCH 

WINDOW 


DISK RESIDENT 
COMPIL COPY 
FIX HELP 

POPVAR PRINT 
SHADE SMOOTH 

ZAPTEX 


CURRENTLY 
CHANGE 
LOGI N 
PERSP 
SCFTRO 


ARE : 
CLIP 
LOOK 
RENAME 
SCFTEX 


CONVRT 
MD IRC 
RESET 
TEXT 


COMMANDS THAT KEEP THEMSELVES AUTOMATICALLY ARE 
EDIT PATHMO TRACE 


examples: keep getlib 

KEEP TREE 
KEEP PUTDSK 

BY THE WAY, YOU HAVE TO USE THE KEEP COMMAND BEFORE YOU USE THE 
COMMAND ITSELF IF YOU WANT IT TO STAY IN CORE. 


// * ******** *** ************************* ** * * ** * * ** * * * * * * ** * * ** * ******* * 

/* 

THERE IS NO HELP ON THAT ONE, IT MUST BE A DOOZY. CHECK YCUR SPELLING 
BY TRYING THAT ONE AGAIN.. 

// * *********** ** * *** * ** ** ************ ********************* * *********** 

// * ******************** ******** ******** ** ***************** ********** le NG TH 

LENGTH 


SYNTAX! LENGTH CHAR STRING,VAR (STRING MANIPULATION) 

LENGTH PLACES THE LENGTH OF THE STRING INTO THE VARIABLE 
SPEC I FIFO. 


EXAMPLE: *$B='GRAPHICS SYMBIOSIS' 

♦LENGTH $ B,A 
♦PROMPT A 

18 

// * ************************** *************************************** LINES 

LINES 

SYNTAX: LINES LNAME 

LINES PUTS LNAME»S VECTORS IN REGULAR DRAWING MODE. IT 
IS USED TO RECOVER FROM DASHES AND POINTS MODES. 


EXAMPLE: LINES DIAMON 

// * ***************************************************************** LIST 

L 1ST 

syntax: list 

LIST CAUSES LINES OF A MACRO TO BE ECHOED DURING EXECUTION. 

IT IS A USEFUL DEBUGGING TOOL. LIST IS TURNED OFF BY XLIST. 

// ****************************************************************** LOGI N 

LOGIN 

IF YOU DON'T KNOW HOW TO USE LOGIN BY NOW, YOU'RE A SUSPICIOUS PERSON. 

IN FACT, THE POLICE ARE COMING RIGHT NOW. 

// * ****************** ******** ********** ****************** * * ********* L COK 

LOOK 

SYNTAX: LOOK ANA ME,V AR 

OR LOOK/D DNAME,V AR 

LOOK CHECKS TO SEE THE THE ANAME IS IN CORE 
(OP WITH /D, ON THE DISK). IF IT IS ON IN CORE (OR ON DISK 
WITH /P) IT RETURNS A VALUE OF 0 IN THE VAR INDICATED. IF IT IS 
NOT THERE, IT RETUPNS A VALUE OF 1. 

EXAMPLE: PROM "WHAT PIX" 

INP SB 

LOOK/D SB.DEC,C 

IF C = 1 »PRO M SB," IS NOT ON DISK'SSK -3 

... 

// ****************************************************************** LPNAMP 

LPNAME 


syntax: lpname svar 

LPNAMF RETURNS THE NAME OF THE PICTURE CORRESPONDING 
TO A LIGHT PEN "HIT" IN THE SVAR INDICATED. IF NO LIGHT PEN 
HIT IS SEEN, THE SVAR REMAINS UNCHANGED. 






SKIP- -1 


// 

/* 

I 

ANY 

// 


IF $C = » • > SK IP- — 1 (WAIT FOR HIT) 

DELETE SC (DELETE THE PICTURE, FOR EXAMPLE) 

******************* ************************************************** 


LOOKED FOR A HELP LISTING FOR THAT COMMAND, BUT I COULDN'T FIND 
MUST NOT BE THERE RIGHT NOW, OR YOU DIDN'T SPELL IT RIGHT. 
********************* ******************************************** 


// *********************************** ******** ********** ** *********** mdirc 

MD IRC 


SYNTAX: 


MDIRC 


MO IRC IS LIKE DIRCOR EXCEPT IT DOESN'T PRINT OUT ALL THE 
INFORMATION THAT DIRCOR SUPPLIES (I.E. NOTES OR TOTALS). MDIRC 
TAKES UP LESS SPACE THAN DIRC SO IT IS USEFUL IF YOU GET 
AN ERROR #13 (OUT OF CORE) WHEN TRYING TO USE DIRC. 


// ****************************************************************** MODIFY 

MODIFY 

SYNTAX: MODIFY ANAME+E XPR ESOTERIC///// 

OR MODIFY ANAME+EXPR,EXPRl,VAR,EXPR2 

OR MOD EXPR 

MODIFY ALLOWS THE USER TO LOOK AT CORE LOCATIONS FOR 
DEBUGGING PURPOSES. THE OUTPUT RADIX IS SET BY SWITCHES ANC 
THE SYSTEM THEN WAITS FOR INPUT TO CHANGE THE CORE LOCAATION. 

IF A <CR> IS SEEN, NO MODIFICATIONS ARE DONE AND MODIFY IS FINISHED. 

IF A <LF> IS SEEN, THE NEXT LOCATION WILL BE ACCESSED. 

IF A ”|** IS SEEN, THE PREVIOUS LOCATION WILL BE ACCESSED. 

IF A "®" IS SEEN,THE CONTENTS OF THE ADD R IS USED AS AN ACCR (INDIRECT). 


IF A NUMBER IS SEEN, IT WILL REPLACE THE PRESENT LOCATION'S CONTENTS 
WITH THAT NUMBER AND DISPLAY THE NEXT LOCATION. 

IF EXPRl,VAR,FXPR2 ARE USED: EXPRl IS ADDED TO ADDR(DEC IMAL) 

VAR GETS OLD CONTENTS OF LOCATION 
EXPR2 REPLACES LOCATION IN CORE(DECIMAL) 
IF EXPR IS LEFT OUT ENTIRELY, MOD USES THE LAST ADDRESS USED BY 
MGD OR SETBFK. 


switches: 


/A 

- FOR 

/B 

- FOR 

/D 

- FOR 

/O 

- FOR 

/V 

- FOR 


ASCII REPRESENTATION 

BYTE REPRESENTATION 

DECIMAL REPRESENTATION 

OCTAL REPRESENTATION (DEFAULT) 

VECTOR GENERAL ADDRESSES 


EXAMPLES: MOD VG+2000 

MOD GRAPE+100 
MOD 77646 

// ******************************* *********************************** MOVE 

MOVE 

SYNTAX: MOVE PNAME,DEVI,DEV2,DEV3 

THE MOVE COMMAND TRANSLATES THE PNAME ALONG THE COORDINATE 

AXES THE AMOUNT INDICATED BY DEVI FOR X, DEV 2 FOR Y AND DEV3 FOR Z. 

MOVE USFS THE DEVICE CONVENTIONS OUTLINED IN "HELP DEV" 

example: move grape,di 

MOVE TOM, F 

THE FIRST EXAMPLE MOVES THE GP APE ACCORDING TO D1.D2, ANC D3. 

THE SECOND EXAMPLE MOVES TOM ACCORDING TO THE VARIABLES F,G,A ND H. 

MOVE SAM,05,RA,1000 

THIS MOVES SAM ACCORDING TO D5 (X-AXIS), VARIABLE RA(Y-AXIS) 

AND A CONSTANT 1000 (FOR Z-AXIS). 

// * ********** ******** ** ** ** *********************************** ***** *** 

/ * 

HMMMMMM, SOMETHING IS AMISS HERE, EITHER THERE ISN'T ANY HELP ON 
THAT COMMAND, OP YOU CAN'T SPELL IT RIGHT. LET'S TRY IT ONE MORE 
TIME, OK? 

// ********************************************************************** 

// ******************************************************************** 

/* 

NO NO NO, YOU'RE GONNA GET NO WHERE FAST ASKING FOR HELP ON A COMMAND 
THAT STARTS WITH AN "N". LET'S FACE IT, YOU BLEW THE SPELLING 

// *************************** **************** ************ * * *********** 

// ****************************************************************** onerrc 

ONERROR ‘ 



ONERROR SETS UP A COMMAND TO BE EXECUTED IN THE EVENT 
AN ERROR OCCURS. THE SYSTEM STICKS THE ERROR NUMBER IN THE 
VARIABLE INDICATED AND EXECUTES THE COMMAND YOU SPECIFIED 
AFTER THE COMMA IN PLACE OF THE COMMAND WHICH CAUSED THE 
ERROR. (NOT F THAT IT ALSO THROWS OUT THE REST 
OF THE LINE IN ERROR TOO.) 

SKIPS TN ONERROR COMMANDS ARE TAKEN RELATIVE TO THE 
LOCATION OF THE COMMAND IN ERROR, NOT TO THE LOCATION OF THE 
ONERROR COMMAND ITSELF. IF THIS CAUSES CONFUSION, REMEMBER TO 
HAVE ALL ONERROR SKIPS REFERENCE %LABELS INSTEAD. THEN IT'S OK 
AND EVEN EASY TO FIGURE OUT. 

YOU CAN EVEN CALL A MACRO IN THE EVENT OF AN ERROR. 

THIS IS IMPORTANT IF THERE IS A POSSIBILITY OF 
MULTIPLE ERRORS OCCURRING. THIS IS WHY THE ERROR NUMBER 
IS PUT IN THE VARIABLE. 

EXAMPLE: ONERROR VA.DO FIXUP 

where fixup is: 

fixup: <if va=13,delete $b;peturn 

if a=i,getdsk $a;return 

...E TC.> 

THE ERROR NUMBERS ARE GIVEN IN ERRMES.SYS 31,A IN THE RIGHT MARGIN. 

SWITCHES: /A - IGNORE ALL ERRORS 

NOTE THAT /A IS A DANGEROUS WAY TO DO THINGS. 

ONERROR WITHOUT ANY OPERAND CANCELS THE SETUP. 

YOU SHOULD CANCEL ONERRORS WHEN YOU ARE DONE 
WITH THEM SO THEY DO NOT DO WEIRD THINGS WHEN 
AN ERROR IS ENCOUNTERED SOMETIME LATER ON. 

RESTART CANCELS ALL ONERRORS. 


ONERROR A, GETDSK WITCH.DEC 31,1 
GETDSK WITCH 

IN THIS EXAMPLE, IF THE WTTCH IS NOT FOUND 
IN THE USERS AREA, INSTEAD OF GIVING AN ERROR 
MESSAGE, THE WITCH WILL BE TAKEN FROM THE 
COMMON AREA OF THE DISK. 

ONERROR A,GETD $A!SK 0 
ROTATE $A,X »DO 

THE ABOVE WILL GET THE PIX FROM THE DISK IF IT IS NOT IN CORE BECAUSE 
ROTATE SENSES AN ERROR. THE **SK O'* RE-EXECUTES THE ROTATE INSTRUCTION. 
// *************************** ******** ******** ************** ******** * 

OPENO 

syntax: OPEN PIX 

OPEN TS USED TO SET THE NAME FOR FUTURE PUTPOI'S AND 
DELPOI'S. IF YOU DO A PUTPOI WITHOUT AN OPEN, YOU WILL GET AN 
ERROR MESSAGE. 

examples: OPEN SAM 

OPEN $ A 

THE NORMAL SEQUENCE IS: 

OPEN PIX 
X=1000 

PUTPOI X,X,0,0 
PU T P X,-X,0,0 
PUTP -X,-X,0,0 
PUTP -X,X,0,0 
PUTP X,X,0,0 
CLOSE 

THIS WILL DRAW A BOX. 

A SIMPLE MACRO TO COPY EVERY OTHER POINT IN A PICTURE WOULD BE: 

COPFN FOO 
N= 0 

X MOPE N=N+l 
GETP OLD,N,X»Y,Z,K 
IF K=-1.CLOSEIRFTURN 
N = N+t 

GETP OLD,N«X»Y,Z,K 

if k i »putp x,y,z,k;sk XMORE 
CLOS E> 

NOTE THAT K=-I IN A PUTPOI IS REALLY TAKEN AS A 0. IT DOES NOT 
TERMINATE THE PICTURE AS IT WOULD IN ZAPPOI. ONLY CLOSE CAN TERMINATE 
AN OPEN'ED PICTURE. 

// ***************************************************************** 
/* 

AH-OH, I CAN'T SEEM TO FIND HELP ON THAT COMMAND. IT MIGHT NOT BE 
HERE, BUT CHECK YOUR SPELLING, AND TRY THAT ONE AGAIN. 

// ***************************************************************** 
// ****************************************************************** 

PATHMOV 


note: 


example: 


CPEN 


PATHM 




OR PATHMOV PNAME.PIX,VAR.DEV.DEV 

PATHMOV MOVES PNAME TANGENTIALLY ALONG PIX. THE 
VAR INDICATES THE POSITION ALONG THE PATH AND RANGES FROM 0 TO THE 
NUMBER OF POINTS IN PIX. RESETTING THE VAR ANYTIME CAUSES 
THE PATHMOV TO RESUME AT THAT POINT. SETTING IT TO ZERO STARTS IT 
FROM THE BEGINNING. 

THE FIRST DEV IS THE SPEED. BELOW 0, IT 
CAUSES AN INTERPOLATION BETWEEN POINTS. FULL NEGATIVE STOPS IT. 

IF THE DEV IS POSITIVE, THE SPEED IS TAKEN AS THAT MANY 
POINTS PER 1/60 SECOND. THE SECOND (OPTIONAL) DEV IS USED TO 
GIVE FINENESS WHICH HELPS SMMOOTH THE PATH SOMEWHAT. 

PATHMOV DOES NOT USE THE NEW DEV CONVENTIONS IN HELP DEV. 

WHEN THE END OF THE PATH IS REACHED, THE VAR IS SET TO -1. 

EXAMPLE: PATH BIRD,PAT1,A,00 

NOTE: THE VAR (A, IN THIS CASE) IS SET TO -1 WHEN THE END OF THE 
PATH IS REACHED SO THE FOLLOWING SETUP WOULD CAUSE THE PATH TO BE 
INDEFINITELY REPEATED: 

PATH BIRD,PAT!,A »D0 
DOL <IF A LT 0,A =0> 

SEE HELP DOLOOP IF THIS IS CONFUSNG. BASICALLY, IT 
JUST SETS A TO ZERO WHENEVER IT GOES NEGATIVE. 

// ******* ******* ********* ******** *********************************** PENOFF 

PENOFF 

SYNTAX: PENOFF 

PENOFF TURNS THE LIGHT PEN OFF. 

// ***** ** ************ ************ **** ************ ******************* PERSP 

PER SP 

SYNTAX: PERSP PIXl ,PIX2, AEXPR, SCALE 

WHERE SCALE IS AN EXPR 

PERSP CREATES A NEW PICTURE BY MAKING VARIOUS HARDWARE 
MODIFICATIONS TO A PICTURE (SPECIFIED BY PIXI), AND PUTTING THE 
MODIFIED PICTURE INTO THE NAME GIVEN BY PIX2. 

PERSP THEN DOES A VIEWING PERSPECTIVE TRANSFORMATION ON 
THE NEW PICTURE. BY ASSUMING THAT THE VIEWER IS AT A SCREEN COORDINATE 
SPECFIED BY AEXPR ON THE Z-AXIS. 500 IS THE DEFAULT VALUE USED 
FOR THE SCALE ARGUMENT. A SCALE FACTOR OF 1000 WILL DOUBLE THE 
SIZE OF THE OUTPUT PICTURE, 250 WILL REDUCE THE SIZE OF THE 
OUTPUT PICTURE BY 1/2, ETC. 

THE OLD PICTURE IS NOT AFFECTED IN ANYWAY BY DOING A 
PERSPECTIV E. 

/C - OPERATES THE SAME AS ABOVE EXCEPT H ARCW ARE 
MODIFICATIONS ARE IGNORED AND AEXPR CAN 
BE SUBSTITUTED WITH XEXPR, YEXPR, ZEXPR 
THAT WILL SPECIFY THE POINT OF PERSPECTIVE 
CRGIN (I.E. THE /C SWITCH ASSUMES THE 
VIEWER IS LOOKING TOWARD THE SCREEN CRIG1N 
FROM THE COORDINATES GIVEN BY XEXPR, YEXPR 
AND ZEX°R, ONE OF WHICH MUST BE NON-ZERO) 

PERSP TV »FOO,500,250 

THIS WILL DO A PERSPECTIVE TRANS. ON THE PICTURE 
TV WITH THE VIEWER AT Z-C0OROINATE 500. THE 
RESULTING PICTURE IN «F00» WILL BE 1/2 THE SIZE 
. OF THE ORIGINAL. 

PERSP/C STEEPLE.DOW,0,20 00.100 0,1000 

THIS PERSPECTIVE WILL BE DONE BY PLACING THE 
VIEWER AT COORDINATES 0,2000,1000 AND THE 
RESULTING PICTURE WILL BE TWICE NORMAL SIZE. 

/C PERSPS APE GOOD FOR FOLLOWING A PATH TRROUGH AN OBJECT. 

USE THE PATH COORDINATES TIMES 16 AS ARGUMENTS TO PERSP/C. 

// ****************************************************************** POINTS 

POINTS 

syntax: points pix 

POINTS CHANGES PIX‘S VECTORS TO DISPLAY ONLY THE ENDPOINTS. 

EXAMPLE: P0INT5 MOREY 

// ******************* ** ** ****************************************** * POPVAP 

PCPVAR 

syntax: POPVAR ARGUMENTS ESOTERIC///// 

POP IS THE OPPOSITE OF PUSH. IT IS USED TO RESTORE PUSHED 
VARIABLES. THE ARGUMENTS ARE “AIRED AND MUST BE IN THE 
ORDER A-Z, VA-VZ, WA-WZ. & FA-FZ. THE ARGUMENTS SPECIFIED ARE 


switches: 


examples: 



examples: 

pop 

POP C»FZ RESTORES ALL BUT A & B 

POP A,M,0,VB,VE,FK,FM,FZ RESTORES ALL BUT N, VC 

VD. & FL 

POP VA« VA POPS JUST VA 

THE FOLLOWING TWO EXAMPLES WILL CAUSE AN ERROR BECAUSE 
THE VARIABLES ARE NOT BEING POPPED OFF IN THE PROPER ORDER. 

POP VA * V Z * A * B 
POP A.K.C.F 

// ******************* *********************************************** PRINT 

PRINT 

SYNTAX: PRINT DNAM E•EXT XX,XX 

PRINT IS THE SAME AS "TYPE" BUT IT CREATES HARDCOPY ON THE 
LINE PRINTER INSTEAD OF DISPLAY ON THE VT05. ANYTHING AFTER 
THE NAME (PLUS SPACE) IS TREATED AS A COMMENT AND IS PRINTED AT 
THE TOP OF THE PAGE. DEFAULT PRINTING IS SINGLE SPACING. 

SWITCHES: /D - THE HARDCOPY IS PRINTED WITH DOUBLE 

SPACING (WASTES PAPER). 

/N - SUPRESS THE DATE AND TIME 

EXAMPLE: PRINT DRAW.MAC 

PRINT PATH.DEC 50,53 

// *********************** ******************************************* PROMPT 

PROMPT 

syntax: prompt thing,thing,thing. 

PROMPT IS THE COMMAND USED TO OUTPUT VALUES OF VARIABLES OR 
DEV'S TO THE VT05. IT CAN ALSO BE USED TO 

WRITE MESSAGES TO A MACRO USER AND THUS PROVIDES A MEANS FOR 
ASKING QUESTIONS BEFORE INPUT COMMANDS, TYPING INFORMATION OUT, ETC. 

THING IS EITHER A VARIABLE (STRING OR ARITHMETIC) OP A BUNCH OF LETTERS 
IN DOUBLE QUOTATION MARKS. IF A "|» IS THE LAST CHARACTER ON THE 
LINE, THF CARRIAGE RETURN WILL BE SUPPRESSED AND THE INPUT CAN 
THEN APPEAR ON THE SAME LINE AS THE ONE TYPED OUT. IF ANY ARGUMENTS ARE 
PASSED TO THF MACRO ALL PROMPTS WILL NOT PRINT TO THE TERMINAL UNTIL 
ALL OF THE ARGUMENTS ARE GONE OR INPUT/T IS USED. 

switches: /F - FORCES prompt even if supressed by 

ARGUMENTS IN MACRO CALL. 

/L - PROMPTS ON THE LINE PRINTER. 

/P - IS USED TO ACTUALLY PRINT THE DATA 

PREVIOUSLY SENT TO THE LINE PRINTER. 

note: this has no arguments. 

/O - PRINT OCTAL VALUE OF VARIABLE 

examples: prompt do 

PROMPT "THE ANSWER IS ",DO 
PROMPT "A+B=",A+B,"AND C*D= ",C+D 
PROMPT "PUSH FS13 TO EXIT" 

PROMPT "X COORDINATE"! 

PROMPT FA.FB.C 

PROM "WHAT PTX DO YOU WANT TO SEE»| 

I NP * A 
GETDSK $A 

... 

// ******************* ** ************************ ** ******************* PUSH V A 

PUSHVAP 

SYNTAX: PUSHVAP ESOTERIC//// 

PUSH PUSHES ALL THE VARIABLES IN THE ORDER A-Z, VA-VZ. WA-WZ, 

& FA-FZ IN A PUSHDOWN STACK MANNER (20 DEEP). 

EACH UTILITY MACRO SHOULD PUSH UPON ENTRY & POP UPON EXIT 
TO AVOID CONTAMINATING THE USER'S VARIABLES. IT IS THE MACRO WRITERS 
RESPONSIBILITY TO PAIR THE PUSHES & POP'S CORRECTLY. 

SWITCHES: /C - CLEARS THE VARIABLES AFTER PUSHING THEM 

(I.E. SETS THEM TO 0). 

NOTE: UNLESS THIS SWITCH IS USED, THE VARIABLES 
ARE NOT CHANGED BY PUSH SO ARGUMENTS MAY STILL 
BE PASSEO IN VARIABLES. 

NOTE: PUSH AND POP WORK POORLY WITH DOLOOPING. 

// ****************************************************************** PUTDSK 

PUTDSK 




putdsk puts dname out to your area on THE DISK IN the format 
INDICATED BY THE EXTENSION. 

extensions: 

.DEC PICTURES(DEFAULT) 

.MAC MACROS 

.CPL COMPILE FILES 

.ARA ARRAY FILES 

WHEN THE EXTENSION IS NOT ONE OF THE ABOVE, THE FILE 
WILL BE PUT ON OISK IN .MAC FORMAT, EVEN THOUGH IT MAY HAVE 
ANOTHER THPEE LETTER EXTENSION. THERE IS ALSO AN OPTIONAL 
ARGUMENT WHICH MUST BE A $VAR. IF THIS IS SPECIFIED, THE $VAR*S 
CONTENTS WILL BE PUT ON THE DISK WITH THE DNAME SPECIFIED. 

IF THE EXT IS NOT PRESENT PUTDSK WILL TRY TO FIGURE OUT WHAT IT IS AND 
USE THE PROPER EXTENSION FROM ABOVE. IF NO EXT IS SPECIFIED 
THE PROPER ONE WILL BE ASSUMED. 

YOU CANNOT PUTDSK ON ANY AREA BUT YOUR OWN. 

SWITCHES! /D - CREATES A BACKUP FILE WITH THE EXT .BAK IF 

THE FILE ALREADY EXISTS ON THE DISK. VERY 
USEFUL WITH THE QUICKY EDITOR (EDIT). 

/A - THIS WILL ADO TO THE FILE ALREADY ON DISK. 

THIS COULD CREATE VERY LARGE DISK FILES IF 
USED INDISCRIMINATELY. IF THE DISK FILE DOES 
NOT EXIST, THE /A IS IGNORED AND THE COMMAND 
PROCEEDS AS A NORMAL PUTDSK. 

/M - COMPLEMENT TO GETDSK/M, AS IT IGNORES 
EXT ENT ION CHECKING. IT PUTS THE FILE 
ON THE DISK AS IF IT WERE A MACRO. 

/B - COMBINATION OF /M & /A 

EXAMPLES: PUTDSK DRAW.MAC 

PUTDSK GLOBE 
PUTDSK WITCH.DEC 
PUTDSK TEMP.MAC,$C 
PUTDSK HELLO.TRY 

// * ******** **** ****** ** ************************** ******************* puTLIP 

PUTLIB 

syntax: putlib pname 

PUTS PNAME INTO NON-DISPLAYED DATA STRUCTUPE AND REMOVES 
PNAME FROM HIGHER GROUPS IF ANY. PNAME MUST BE DISPLAYED. 

THE COMMANDS WHICH WORK ON A PUTLIB*D PNAME APE AS FOLLOWS: 


BL ank 

CUTOFF 

CLOSE 

CLIP 

COPY 

DASHES 

DELETE 

DELPO I 

FIX 

GETL IB 

LOOK 

LINES 

MOVE 

PATHMOV 

PER SP 

POINTS 

PUTDSK 

PUTPOI 

PUTTEX 

RENAME 

RESET 

ROTATE 

SCALE 

SETCQ 

SETINT 

SETORG 

SHADE 

SMOOTH 

SOFTRO 

ZAPPOI 

ZAPTEX 

WI NDOW 


NOTE THAT THE UPDATES TO PNAMES ARE NOT DONE WHILE THE PNAME IS 
PUTLIB»D. TO HAVE THE UPDATES DONE BUT NOT USE UP COMPUTER TIME 
TO DISPLAY THE PIX (FOR PIX ONLY) YOU CAN USE THE BLANK COMMAND. 

GETLI8/W IS ALSO USEFUL FOR GETTING THE PNAME BACK SMOOTHLY. 

example: putlib outline 

// ********* ********** ** ********** **************** **** ********* * ***** PUT POI 

PUTPOI 

SYNTAX: PUTPOI X,Y,Z,K 

WHERE X,Y.Z,K ARE EXPRS 
OP PUTPOI/C PNAME»EXPR1 ,EXPR2 ,K 

PUTPOI PUTS A POINT INTO THE PIX INDICATED BY THE PREVIOUS OPEN. 

X,Y,Z ARE ANY EXPRESSIONS DETERMINING THE X,Y, AND Z COORDINATES OF THE 
POINT IN DECIMAL (RANGE -2048 TO 2047). K INDICATES THE FOLLOWING: 

K=0 DRAW THE VECTOR 

K=l MOVE TO NEW LOCATION BUT 00 NOT DRAW (THAT IS, JUMP) 

TO TERMINATE THE LIST, USE THE CLOSE COMMAND. ALSO NOTE THAT 
THE FIRST POINT IS ALWAYS STORED AS K=1. 

SEE HELP PIX FOP MORE INFORMATION ON CREATING PICTURE LISTS. 

SWITCH: /C COPIES A RANGE OF POINTS FROM ANOTHER PIX 

EXAMPLE: PUTPOIN DO/16,D1/16/D2/16, 1 

PUTPOI A ,B ,C ,0 
PUTPOI 0,0,0,-1 

THIS WILL CREATE A PICTURE WITH A LINF DRAWN FROM THE 
INSTANTANEOUS POSITIONS OF D0,01,AN0 D2 TO THE POSITIONS 
OF THE VARIABLES A,B, AND C. (THE /16 IS NECESSARY BECAUSE DIALS 
ARE READ LEFT JUSTIFIED.) 

example: open sambox 

PUTP 0,0,0,0 



PUTP 1000,0,0,0 
PUTP 0.0,0.0 
CLOSE 

THIS WILL CREATE A BOX IN THE UPPER RIGHT QUADRANT 
OF THE SCREEN. THE BOX IS NAMED SAMBCX. 

example: open beep 

PUTP/C PAUL,10,20,1 

THIS WILL COPY VECTORS 10 TO 20 OF PAUL INTO BEEP, STARTING OFF WITH AN 
UNDRAWN VECTOR. REGULAR PUTPOI'S CAN PRECEED AND FOLLOW PUTP/C'S. 

// ******* **** ** **** ** ** *************************************** ****** PUTTE X 

PUTTEXT 

SYNTAX: PUTTEXT XEXPR,YEXPR,ZFXPR 

+ SOME TEXT TO BF USED 

THIS COMMAND WILL DISPLAY THE SPECIFIED TEXT ON THE VG. 

THIS TEXT WILL THEN BE INCORPORATED INTO THE CURRENTLY OPEN'D 
PICTURE (SEE OPEN). IT IS LIKE PUTPOIN EXCEPT 

IT PUTS TEXT INSTEAD OF POINTS. THE TEXT IS DISPLAYED AT THE 
COORDINATES SPECIFIED BY XEXPR, YEXPR, AND ZEXPR. THE EXPR 
VALUES RANGE FROM -2046 TO 2047. 

SWITCHES: JUST LIKE IN TEXT 

note: TEXT SHOULD BE PUT AT THE END 

OF THE PICTURE IF THE PICTURE IS TO LATER EE 
MANIPULATED WITH GETPOI OR ZAPPCI. 

DON'T PUT A **» AS THE FIRST CHARACTER. 

BECAUSE THE SYSTEM WILL THINK IT'S A 
COMMENT. 


// *********** ************ ******** **** ********************************* 

/* 

SORRY ABOUT THIS, BUT THE INFORMATION THAT YOU WANT DOESN’T EXSIST 

AT THIS POINT IN TIME. IS YOUR SPELLING INOPERATIVE?? 

// * **************************************************************** 

// ******************************************************************** 

/* 

QUIT IT WILL YA, YOU MUST BE QUAZY IT THE HEAD. YOU TRIED TO GET 
HELP ON A COMMAND THAT THAT BEGINS WITH A «Q«. CHECK YOU'RE SPELLING. 

/ / ********************************************************************* 

// ****************************************************************** RENAMF 

RENAME 


syntax: 


RENAME ANAME 1 .ANAME2 


RENAME SIMPLY CHANGES THE FIRST NAME TO THE SECOND NAME. 

switches: 

NONE AS ABOVE 

/D RENAMES DISK FILE ON YOUR AREA 


EXAMPLFS: GETDSK GRAPE 

RENAME GRAPE,PRUNE 
GETDSK GRAPE 

NOW THERE ARE TWO COPIES OF GRAPE ON THE VG SCREEN. 


RENAME/D GRAPE.DEC,PRUNE.DEC 
GRAPF.DEC IS NOW CALLED PRUNE.DEC ON THE DISK. 

// ******************* ** ** **** ************************** ** ****** ** *** RESET 

RESET 

SYNTAX: RESET PNAME 


RESET IS THE SAME AS FIX EXCEPT THAT THE ORIGINAL VALUES OF THE 
ROTATION MATRIX, ORIGIN, SCALE, INTENSITY, ETC. ARE RESTORED. 


switches: 

SAME AS FIX 

example: reset/r prop 

// ******************* *********************************************** RESGLV 

RESOLVF 

SYNTAX: RESOLVE MN AMF1,M NAME2 ESOTERIC///// 

OR RESOLVE MNAME 

P F SOLVE CONVERTS %LABEL PSEUDO-LABELS IN MNAME1. IF A 
MACRO HAS PSEUDO-LABELS, RESOLVE CAN BE USED TO REMOVE THEM. THE 
ONLY RFASON TO USE IT IS TO MAKE THE MACRO RUN SLIGHTLY FASTER. 

PSEUDO-LABELS ARE USFD TO EL IM IN ATE THE TASK OF COUNTING 

LINES FOR SKIP ARGUMENTS IN LONG MACROS. MNAMEl IS AUTO-OELETED. 

IF THE SINGLE MNAME IS USED THE RESOLVED MACRO WILL HAVE THE 
SAME NAME AS THE UNRESOLVEO ONE. 

NOTE*. WHEN YOU ORIGINALLY DFFINE THE XLABFL YOU MUST HAVF 



EXAMPLE 


GLOa:<IF F SI » SKIP XFLUFF 
SKIP -I 

xfluff dircor> 

RESOLVE GLOB .CGLOB 
CGLOB NOW LOOKS LIKE: 

cglob:<if fsi.skip 2 

SKIP -1 
DI»COR> 

GLOB IS AUTO-DELETED AND CGLOB CAN BE EXECUTED. 

■ NOTE THAT THIS ALL REALLY ISN'T NECESSARY SO FORGET RESOLV. 

// * * *******44*’!'** **** ** ************** ** ** * ************* ************* RESUME 

RESUME 

syntax: resume 

RESUME IS HOW YOU GET BACK TO THE MACRO IN PROGRESS WHEN 
YOU ARE IN 4-MODE. YOU GET INTO 4-MODE FROM TYPING IS. WHEN 
AN ERROR CONDITION IS ENCOUNTERED, OR WHEN YOUR MACRO 
HAS A WAIT COMMAND EXECUTED (FAIRLY RARE,ACTUALLY). 

YOU CAN ALSO GET INTO 4-MQDE WITH A jS DURING A GETDSK. 

IN 4—MODE YOU CAN EXECUTE ANY GRASS COMAMANDS OR 
EVEN MACROS BUT ALL FURTHER |S USAGE IS IGNORED UNTIL RESUME IS TYPED. 

// ****************************************************************** REST AP 

RESTART 

SYNTAX: RESTART 

OR RESTART DO MNAME 

OR RESTART ANY OF THE COMMANDS ON THE SYSTEM 


RESTART RE-INITIALIZES THE ENTIRE GRASS SYSTEM. 

IF THE CALL OR DO MNAME IS INCLUDED, RESTART CLEARS THE SYSTEM AND THEN 
DOES THAT MACRO AUTOMATICALLY. (ACTUALLY, MOST COMMANDS WILL WORK 
—E.G. RESTART GETC GRAPE-- BUT FEW ARE USEFUL IN THIS CONTEXT.) 


switches: 

examples: 


/V - THE VALUES OF THE ARITHMETIC VARIABLES 
WILL NOT BE SET TO ZERO. 


REST 

RFSTART 

RESTART 

RESTART 


CALL DEMORY 
DO CTITLE 
DO DBLPOI.MAC 


XX ,XX 


NOTE THAT UPON RESTART, VARIABLE WZ IS RESET TO 32767. 

// ****************************************************************** pejypt 

RETURN 


syntax: return 

RETURN IS USED TO LEAVE A MACRO FROM THE MIDDLE. IT IS 
CONCEPTUALLY AND OPERATIONALLY EXACTLY EQUIVALENT TO A 
SKIP 9999. 


example: fixup: <if a=i3,prom »out of core” -.return 

if A=l,PROM "CAN'T FIND THAT”;RETURN 
IF A=2, PROM “THAT * S DUMB"> 

NOTE THAT A RETURN IS ASSUMED AT THE ENO OF EVERY MACRO. YCU DC NOT 

HAVE TO PUT ANTHING SPECIAL AT THE END OF A MACRO, IT RETURNS AUTOMATICALLY. 

// ***** ********************** *************************************** POTA T r 

ROTATE 


syntax: 

ROTATE 

OR 

rotate 

OR 

ROTATE 

OR 

rotate 


PNAME,A XIS,SPEED 
PNAME,AXIS,SPEED,TILT 

PNAME »A XIS.SPEED,TILT * DEV 1,DEV2,DEV3 
PNAME,7.SPEED «X1*Y1*Z1» X2» Y2» Z2 
WHERE AXIS,SPEED »TILT,Xl,Y1» Z1,X2,Y2»Z2 AND 
DEVI ,DEV2.DEV3 ARE ALL DEVS 


ROTATE TAKES THE PNAME A NO ROTATES IT ACCORDING TO THE 
AXIS (MUST BE INDICATED AS ”X”, ”Y", OR ”Z”) AT THE 
SPEED (OR WITH /D, THE ANGLE) INDICATED BY A DEV. IF INCLUDED, 
THE TILT MODIPIES THE AXIS ACCORDING TO THE SETTING OF A DEV. 

IF INCLUDED, DEVI, DEV2, AND DEV3 ARE THE ORIGIN OF THE AXIS 
OF ROTATION. 


THE /D SWITCH MAKES THE SPEED INTO AN ANGLE. 


TO GET AN ANGLE 

OF 180 

DEGREES, SET 

THE 

SPEED 

DEV 

TO 

32767 

(=WZ> 


90 

DEGREES, SET 

THE 

SPEED 

OF V 

TO 

16383 

(=WZ/2) 


45 

DEGREES, SET 

the 

SPEED 

DEV 

TO 

8 19 1 

(=W Z/4) 

30 

DEGREES 

, SET THE SPEED 

DEV TO 

WZ/6 

ETC. 



ROTATE USES THE 
switches: 

/D 

/X 

/ V 


DEVICE CONVENTIONS OUTLINED IN "HELP DEV” 

DEV INDICATES ANGLE OF ROTATION INSTEAD OF 
COMPLEX ROTATION ADDED TO REGULAR ROTATION 


SPEED 
( X ) 



note: on /x./y./z rotations,the axis is not specified again, 
also note: a regular rotation must be done before a /x,/y,/z 

MAY BE USED. 

also also note: since rotations are not commutative, it is important 

TO KNOW THAT THE ORDER YOU SPECIFY THE /X,/Y OR /Z ROTATIONS WILL CHANGE 
THE OVERALL POTATION. 


IF THE CHARACTER *7* IS SPECIFIED IN PLACE OF THE AXIS OF 
ROTATION, SEVEN DEV'S ARE EXPECTED, ONE FOR SPEED AND SIX TO 
INDICATE THE ENDPOINTS (X1,Y1,ZI AND X2,Y2,Z2 IN THAT ORDER) 

OF THE AXIS OF ROTATION TO BE USED. 

ALL SWITCHES WORK IN THE SEVEN-DIAL ROTATE (/D ETC.) TOO. 

SETORG WORKS WEIRDLY WITH 7-DIAL BUT DOES A PRE-ROTATION 
MOVE WITH 2 OR 5 DIAL ROTATES. SETORG DOES NOTHING 
WITH SINGLE DIAL ROTATES EXCEPT SET THE ZOOM POINT FOR SCALES 
WITH SWITCHES. (SEE HELP SCALE, HELP SETORG) 

EXAMPLES: rotate PR0P,X,O9 

ROT/D CUBE,Z,D8 
ROTATE GLOBE,X,DO,Dl 
ROTATE/Z GLOBE,WA 
ROTATE BLADE,Z,DO,Dl,02 
ROT/X BLADE,D5 
R0T/Y BLADE,D6 

(THESE THREE INSTRUCTIONS CAUSE A 
ROTATION WITH LOTS OF CONTROL) 

ROTATE SAM,X,D0,Dl,A 
ROTATE/D FRED, K, L, F 

ROT LARRY, 7,DO ,A ,B ,C ,0 ,E ,F WHERE ENDPOINTS OF THE 

AXIS OF ROTATION ARE 
IN VAR'S A-F 

// ****** ***** *** * ****** **** ** ******** ************************* ******** 

/* 

THAT INFORMATION ISN'T IN THE FILES AS OF YET, BUT CHECK YOUR SPELLING 
JUST TO MAKE SURE. 

// ******************************************************************** 

// ************* ********** ******** ******** ******** ********* * Jje 4= **** ** $ SCALE 

SCALE 

SYNTAX: SCALE PNAME,DEV 

SCALE CHANGES THE SIZE OF PNAME BY A FACTOR INDICATED 
BY THE DEV. THIS SCALE ONLY SCALES DOWN FROM THE ORIGINAL SIZE. 

TO SCALE UP, USE THE MACRO "CALL BIGGER". 

SW I TC HE s: 

NONE USES HARDWARE SCALE WHICH SCALES TO PICTURE'S ORIGIN 

AS MODIFIED BY MOVE, ROTATE, ETC.. 

/X SCALES ALONG X AXIS (SINGLE DIMENSIONAL SCALING). 

/Y SCALES ALONG Y AXIS. 

/Z SCALES ALONG Z AXIS. 

/A SINGLF DIMENSIONAL SCALING ON DEV,DEV+1 AND DEV+2. 

/F SAME AS /A BUT ALL ON SAME DEV 

SCALING WITH SWITCHES ALSO ALLOWS THE OFIGIN OF SCALE TO BE 
RESET BY USING SETORG COMMAND. 

EXAMPLES: SCALE TOM,DO 

SCALE/X N0SE.D9 
SCALE/A SPIRAL, J 

THE LAST LINE TAKES J FOR X SCALE, K FOR Y AND L FOR 
Z SCALE. 

NOTE: SCALE USES THE NEW DEVICE CONVENTIONS (SEE HELP DEV). 

// ****************************************************************** SFAPCf- 

SEARCH 

(STRING MANIPULATION) 

THE SEARCH COMMAND IS A STRING MANIPULATOR COMMAND WITH THE 
FOLLOWING SYNTAX: 

SEARCH/R SA,B,SC,$D - IN THE TARGET STRING SA . START SEARCH 

AT LOCATION B RELATIVE TO 1ST STRING 
POSITION, SEARCH FOR FIRST OCCURRENCE 
OF $C AND REPLACE WITH ID. (NULL ARG FOR 
B STARTS SEARCH AT POSITION 1.) 

SEARCH/R IA,B,XIC,$D - LIKE ABOVE EXCEPT SEARCH FOR THE XTH 

OCCURRENCE OF $C WHERE X CAN BE ANY 
LEGIT GRASS ALGEBRAIC EXPRESSION. 

SEARCH/R $ A,8 * SC,ID - LIKE ABOVE EXCEPT SEARCH FOR ALL 

OCCURRENCES OE SC AND REPLACE WITH ID 



-J> V, 1 UCl-t I C- U » 


$ A . B »X$C »0 - STARTING AT LOCATION B. SEARCH $A FORWARDS FOR 

THE XTH OCCURRENCE OF $C AND PUT FIRST CHAR»S 
LOCATION IN D. (DEFAULT IS THE FIRST 
OCCURRENCE IF X IS OMITTED). 

$A,8,$C,D - STARTING AT 8. SEARCH $A 

BACKWARDS FOR THE XTH 
OCCURRENCE OF *C AND PUT THE FIRST 
MATCHING CHAR’S LOCATION IN D. 

SA,B,C,$D - IN *A AT LOCATION B FOR C CHAR’S, PUT 

SUBSTR IN $D (PL/1 SUBSTRINGING). 

$A,B,C,$D - IN $A AT B FOR C CHAR’S REPLACE WITH 

$D • 

// *********************** ******************************************* SETBPK 

SETBRK 

SYNTAX: SETBRK EXPR ESOTERIC///// 

OR SETBRK ANAME+EXPR (INCLUDING ALL NAMES IN NAMES TABLE) 

SETBRK SETS US A BREAK-POINT AT THE LOCATION INDICATED. 

THE REGISTERS ARE PRINTED OUT AND THEN ANY COMMAND INCLUDING MODIFY MAY 
BE USED TO HELP DEBUG SOME CODE. TO DEBUG SWAP MODULES, "KEEP" THEM 
AND SET THE BREAKPOINT AFTER THEY ARE IN CORE. CORE RESIDENT MODULES 
MAY BE DEBUGGED BY SETTING BREAKPOINTS ART ABSOLUTE LOCATIONS 
OR OFFSETS TO THE VARIOUS MODULES (E.G. VG+2276, SUB+5000). 

REMOVE THE BREAKPOINT BY TYPING SETBRK 0 OR SETTING A DIFFERENT 
BREAKPOINT LOCATION. YOU CAN RESUME THE CODE BY TYPING "RES”, 

ALTHOUGH THE BREAKPOINT WILL GO AWAY. 

EXAMPLES: SETBRK DIRCOR+2200 

SETBRK HELP+4 

// ****************************************************************** SETCO 

SETCQ 

SYNTAX: SETCQ PNAME.DEV 

SETCQ SETS THE CUTOFF PLANE (Z-AXIS CUEING) ACCORDING TO THE VALUE 
SPECIFIED BY THE DEV. IF THE DEV IS SET TO SLIGHTLY NEGATIVE, 

THEN VARYING THE INTENSITY SET BY SETINT WILL MOVE THE CUTOFF 
PLANE WITH RESPFCT TO THE Z-AXIS. IF OEV IS SET TO FULL POSITIVE, 

THE DEPTH CUEING FEATURE WILL BE MOST PROMINENT WHEN THE 
INTENSITY DEV IS VARIED. 

example: setcut globe,db 

NOTE: SETCQ USES THE NEW DEV CONVENTIONS (SEE HELP DEV) 

// *********** ********** ************** ****************** ************* s£ tdei 

setdela 

SYNTAX: SETDELA EXPR 

THE DELAY, INDICATED BY A EXPR, IS USED TC SLOW DOWN GETDSK 
FOR .DEC MODE. SETDELA REMAINS SET FOR THE REST OF YOUR SESSION 
OR UNTIL RESET BY, FOR EXAMPLE: 

SETDELA 0 

ANYTHING LARGER THAN 10 IN SETDELA IS PRETTY SLOW. 

// ****************************************************************** SETIN T 

SETINT 

SYNTAX: SETINT PNAME.DEV 

SETINT SETS THE INTENSITY OF THE PNAME AS INDICATED BY THE 
DEV USED. 


EXAMPLE: SETINT GLOBE,DO 

NOTE: SETINT USES THE NEW DEV CONVENTIONS (SEE HELP 
// *********************************************** 
SETORG 

SYNTAX: SETORG PNAME.DEV 1,DEV2,DEV3 

SETORG SETS THE ZOOM POINT OF A PICTURE FOP 
SCALING. IT DOFS NOT AFFECT REGULAR SCALING. 

SETORG ALSO SETS THE PRE-ROTATION TRANSLATION FOR 2 
EXAMPLE: SETORG SAM.JS 

NOTE: SETORG USES THE NEW DEV CONVENTIONS (SEE HELP 
// *********************************************** 

shade 


DEV ) 

******************* SETOPC 

SINGLE-DIMFNS ional 
AND 5-DIAL rotates. 

DEV) 

******************* SHADE 


SEARCH/F 

SEARCH/L 

SEARCH/T 

SEARCH/S 



WHERE SPACING AND ANGLE ARE EXPRS 


SHADF FILLS IN SURFACES OF THE PICTURE SPECFIED BY PIXI. A 
PICTURE TO BE SHADED MUST BE COMPOSFD OF A SERIES OF CQPLANAR 
SURFACES (I.E. SITUATED IN THE SAME PLANE). EACH SEPARATE PLANE 
OF THE PICTURE MUST BE A CLOSED SURFACE FOR PROPER SHADING (THAT IS. THE 
FIRST POINT OF A PART IS ALSO ITS LAST POINT BEFORE JUMPING 
TO THE NEXT PLANE OF THE PICTURE). 

PIX2 IS THE NAME GIVEN TO THE GENERATED SHADE VECTORS. 

SPACING IS THE DISTANCE BETWEEN THE SHADE VECTORS. 

IF SPACING IS NOT GIVEN THE DEFAULT VALUE IS 10 UNITS. 

ANGLE IS THE ANGLE. IN DEGREES, AT WHICH THE SHADE VECTORS 
ARE DRAWN. IF NOT GIVEN AN ANGLE IS CALCULATED THAT USES 
THE LEAST AMOUNT OF CORE SPACE. 

BE CAREFUL WHEN USING SHADE. BE SURE PIXI IS DRAWN IN 
PROPER FORMAT AND WATCH SPACING OF SHADF VECTORS BECAUSE 
CORE GETS USED UP FAST WITH CLOSE SPACING. 

examples: 

SHADE PRYM,POO,20.90 
SHADE BOX,SAM 

// *******:*********** * ******************** *************************** SK I P 

SKIP 

syntax: skip expr 

OR SKIP SSL ABEL 

SKIP IS USED TO TRANSFER CONTROL WITHIN A MACRO FOR LOOPING. 

EXPRESSION MUST EVALUATE TO A NUMBER WHICH, IF NEGATIVE,SKIPS BACKWARDS 

THAT NUMBER OF LINES. IF POSITIVE, CONTROL SKIPS FORWARD THAT 

NUMBER OF LINFS. NUMBERS LARGER THAN POSSIBLE WITHIN THE 

MACRO WILL RESULT IN TRANSFER TO THE FIRST STATEMENT OF THE PROGRAM IF 

NEGATIVE, OR PAST THE LAST (AND THUS EFFECTIVELY A RETURN) IF 

LARGE POSITIVE. 

example: <x=x+i 

PROMPT X 

IF FS1=0, SKIP —2> 

THIS EXAMPLE WILL INCREMENT X AND PRINT IT UNTIL FS1 IS PUSHED. 

<. • . 

IF FS2=0, SKIP 0 

THIS EXAMPLE WILL WAIT UNTIL FS2 IS PUSHED BEFORE CONTINUING. 

K • . * 

%BACK 

%BACK N=N+1 

IF N LT 200,SK %BACK 

♦ . . ^ 

THE ABOVE SHOWS THE USE OF %LABELS• YOU SHOULD USE XLABELS 
NEARLY ALL THE TIME TO HELP PREVENT THE ONSET OF INSANITY. 

// ****************************************************************** SMOOTH 

SMOOTH 


syntax: 


SMOOTH PIX.EXPR 


SMOOTH 
SMOOTH THE 3-D 


USES A MODIFIED QUADRATIC SMOOTHING TECHNIQUE TO 
PIX THE NUMBER OF TIMES INDICATED BY THE EXPR. 


EXAMPLES: SMOOTH PATH,7 

SMOOTH GLOBE, 11/8-A 

// ******************* ************ **************** ******************* SOF TE X 

SOFTEXT 


SYNTAX: SOFTEXT CNAME,PI X,VAPt,VAR2 

+ ONE LINE OF ANY SOFTEXT EXCLUDING AND 

SOFTEXT AUTOMATICALLY CALLS THE CHARACTER SET CNAME INTO 
CORE IF NECESSARY AND THEN CREATES AN PIX CONSISTING OF ACTUAL 
3D COORDINATES. VAR1 IS USED FOR SPACING BETWEEN CHARACTERS AND 
VAR2 IS USED FOP SIZE OF CHARACTERS. THE CHARACTERS ARE RECRAWN EVERY 
1/10 DF A SECOND USING NEW VALUE OF VAR1 & VAR2. TO STOP REDRAW OF 
PI X PUSH FS15. 

R0M2 DOUBLE LINE ROMAN FONT (UPPER AND LOWER, COMPLETE 
PUNCTUATION) 

SCR SINGLE LINE SCRIPT FONT (UPPER AND LOWER) 

SCR2 DOUBLE LINE SCRIPT FONT (UPPER AND LOWER) 

MAP SELECTED MAP SYMBOLS 

ITALL LOWER CASE ITALIAN GOTHIC FONT 

ITALU UPPER CASE ITALIAN GOTHIC FONT 

ENGL LOWER CASE ENGLISH GOTHIC FONT 

ENGU UPPER CASE ENGLISH GOTHIC FONT 



huau 

ROMSU 

UPPER 

V- M oc 

CASE 

V 1 rt u. L 1 L 1" K.J IN 1 

ROMAN TYPE 





ROMSL 

LOWER 

CASE 

ROMAN 

TYPE 






P0M3U 

UPPER 

CASE 

ROMAN 

TYPE 

(TRI 

PLE 

LI NE 

) 

R0M3L 

LOWER 

CASE 

ROMAN 

TYPE 

( TRI 

PLE 

LI NF 

) 

POM4U 

UPPER 

CASE 

ROMAN 

TYPE 

( QUA 

D 

L 

INES ) 


ROM4L 

LOWER 

CASE 

ROMAN 

TYPE 

( QUA 

D 

L 

INES) 


GEPMU 

UPPER 

CASE 

GERMAN 

TYPE 






GERML 

LOWER 

CASE 

GERMAN 

1 TYPE 







PUNCT PUNCTUT A ION SET 
SPUNCT SPECIAL PUNCTUT A ION SET 

TO INDICATE LOWER CASE IN CHARACTER SETS WITH BOTH UPPER AND LOWER CASE, 
YOU MUST TYPE A "I" BEFORE EACH LOWER CASE CHARACTER TO BE USED. A 
DOUBLF "l” (I.H. ** 1 j " ) IS USED AS A SHIFT LOCK. IF •'ll" IS USED, 

•• •• MUST BE USED TO INDICATE AN UPPER CASE LETTER. 

•• WILL SHIFT 

DISPLAYED ALSO. 

EXAMPLES: 


LOCK TO UPPER CASE AGAIN. TEXT IN A $V ARIABLE CAN BE 


SOFTEXT ITALL,TOMMY,DO,DI 
THIS IS AN EXAMPLE 


A =625 

SOFTEXT SCR2 .SAM ,A ,D0 
G| |R APHICS SYMBIOSIS SYSTEM 

a=30o;b=iooo;fson is 
$A=»HELLO » 

SOFTEXT ENGU,PO GO,A,B 
+JELLC $A YELLOW 


THIS WILL DISPLAY "J ELLO HELLO YELLOW**. 

NOTE THAT SPACES MUST BE ENTERED AS UPPER CASE CHARACTERS. PUNCTUATION 
IN THOSE SETS WHERE AVAILABLE, IS INDICATED BY THE SAME PUNCTUATION 
CHARACTER BEING TYPED. MAP AND RUSU RUSL HAVE SPECIAL CORRESPONDANCES 
AVAILABLE FROM THE SYSTEMS PROGRAMMERS. DON'T USE AS THE FIRST 

CHARACTER, SINCE THE SYSTEM WILL THINK IT'S A COMMENT. 

// **W*********$^*4*** ** ****************** ***************** * ** * *** ** * SCFTR C 

SOFTROT 

syntax: SOFTROT PIX 

SOFTROT TAKES THE VARIOUS HARDWARE MODIFICATIONS TC THE PIX 
(SPECIFICALLY ROTATION* MOVING, AND SCALING) AND SOFTWARE ALTERS 
THE DISPLAY LIST TO GIVE ACTUAL VECTORS REPRESENTING THESE CHANGES. 

SOFTROT THEN DOES A RFSET TO HALT FURTHER HARDWARE ROTATION, MOVING, 

SCALING, UNTIL THE USER RE-ROTATES, ETC. A PUTDSK 

WOULD THFN PUT THE TRANSFORMED LIST ONTO THE DISK. TOO MANY SOFTROT»S 
WILL SLOWLY DESTROY THE PICTURE DUE TO ROUNDOFF ERRORS. 

SOFT DOES NOT DO THE CHANGES REPRESENTED IN CUTOFF, SETINT, AND SETCQ. 


example: rot globe,y,do 

SCALE GLOBE,Dl 
SOFT GLOBE 


// ******* ************ ******************** ****************** ************ 

/* 

NO ONE TOLD ME ABOUT THAT COMMAND YET, SO HOW CAN I TELL YOU? BY THE 
WAY, ARE YOU SURE YOU SPELLED IT RIGHT? 

// ********************* *********************************************** 

// * *********** ************************* ******** ** ****** ** * * ******** * ** TRAC 

TRACE 

SYNTAX: TRACE VAR1,VAR2,... ESOTERIC///// 

TRACE SETS UP THE MECHANISM TO FOLLOW THE VALUES OF THE SPECEIED 
VARIABLES AS THEY ARE CHANGED IN OTHER GRASS COMMANDS. THIS IS A 
USEFUL DEBUGGING AID. 


sw itches: 


/X - TURNS OFF TRACING FOR THE VARIABLES SPECEIED TN 
THE REST OF THE COMMAND. 


examples: 


TRACE A » X, VE ,FR 

THIS WTLL TRACE THE VALUES 
THE USER EVERY TIME ONE OF 
BEEN CHANGED. THE USER IS 
LEVEL, THE MACRO NAME, THE 
AND THE VARIABLE'S NEW VALUE. 

THE COMMAND THAT CAUSED THE VALUE TC 
CHANGE IS ALSO PRINTED ON THE TERMINAL. 


OF A , X,VE,FR AND NOTIFY 
THESE VARIABLES HAS 
TOLD THE MACRO 
LINE * IN THE MACRO 


TPACE/X FR,X 

THIS WILL TURN OFF THE TRACING OF FR & X. 


T RACE/X 

THIS WILL CANCEL TRACING OF ALL VARIABLES USED 



note: dials & arrays cannot be traced. 

A MAXIMUM OF 20 VARIABLES CAN BE TRACED AT ONE TIME. 

// *4* 4 *4 444444444444444444444444444444444444444444444 TEXT 

TEXT 

syntax: text pix,x,y,z 

+ ONE LINE OF TEXT TO BE DISPLAYED 
WHERE X* Y* Z APE EXPRS 

TEXT DISPLAYS VECTOR GENERAL HARDWARE CHARACTERS ON THE VG 
SCREEN. THESE CHARACTERS (SPECFIED BY PIX) ARE NOT STANDARD 
PICTURES, THEY CANNOT BE ROTATED, PUTDSK'D, SCALED, ETC. AS 
SOFTEXT CHARACTERS CAN. 

EACH PIX SIGNIFIES ONE LINE OF DISPLAYED TEXT. 

X,Y,Z ARE EXPRS GIVING THE X.Y.Z COORDINATES OF WHERE PIX IS DISPLAYED ON 
VG SCREEN. THE EXPR CAN RANGE FROM 204T TO -2048. DEFAULT 
PLACEMENT IS AT THE LEFT MARGIN OF THE VG SCREEN. 

SW itchfs: 

/l THRU /4 - DISPLAYS PIX HORZONTALLY ON VG SCREEN 

WITH Z1 BEING SMALLEST CHARACTER SIZE 
AND /4 THE LARGEST. DEFAULT IF NOT 
GIVEN IS /A. 

/5 THRU /3 - DISPLAYS PIX VERTICALLY ON VG SCREEN 

WITH /5 SMALLEST CHARACTER SIZE AND 
/8 LARGEST. 

SPECIAL syntax: 

IF A | IS IN DISPLAY LIST OF PIX THE NEXT 
CHARACTER DISPLAYED IS IN UPPER CASE. 

A •’ll" WILL LOCK DISPLAY IN UPPER CASE CHARACTERS 
THIS IS NORMAL CHARACTER DISPLAY DEFAULT. 

A •' ’• WILL DISPLAY THE NEXT CHARACTER IN LOWER 
CASE TYPE. 

A « *• WILL LOCK DISPLAY IN LOWER CASE CHARACTERS. 

A WIDE RANGE OF SPECIAL CHARACTERS ARE AVAILABLE 
WITH THIS COMMAND. SOME OF THESE INCLUDE MATHEMATICAL SYMBOLS 
AND THE GREEK ALPHABET. TO DISPLAY THESE SYMBOLS, THE OCTAL 
CHAPACTER CODE OF THE DESIRED SYMBOL IS ENCLOSED IN ANGLE 
BRACKETS <"<",»>'•). THE OCTAL CODE FOR ALL THE SPECIAL 
CHARACTERS CAN BE FOUND IN TH C VECTOR GENERAL GRAPHICS DISPLAY 
REFERENCE MANUAL OR IN THE VECTORGPAPHICS 11 PROGRAM REFERENCE 
CARD. 

TO UNDERLINE CHARACTERS, FOR EXAMPLE, USE <10>_ FOR EACH CHARACTER: 

I.E. HELL0<1 0X1 OX 10X 1 OX 1 0>_WILL UNDERLINE HELLO. 

examplfs: 

TEXT SAM,2000,2000,1000 
+HELLO 

THIS WILL DISPLAY THE WORD 'HELLO* 

HORIZONTALLY AT POSITCN 2000,2000, 

1000 IN THE LARGEST CHARACTER SIZE. 

TEXT/5 FA A, —2000,-1000 
+ < 3 4 2 > C OMPUTER (GRAPHICS 

THIS WILL DISPLAY VERTICALLY, STARTING 
AT POSITION -2000,-1000,0. THE GREEK LETTER 
BFT A (FROM THE OCTAL CODE <342>) FOLLOWED 
BY THE STRING 'COMPUTER GRAPHICS* WITH 
THE FIRST LETTER IN EACH WORD CAPITALIZED 
WHILE THE REST OF THE STRING IS IN LOWER 
CASE. THE ENTIRE LINE WILL BE IN THE 
SMALLEST CHARACTER SIZE. 

TEXT GA 

+ $A <2 75 > < 27 7 > 

THIS WILL DISPLAY IN UPPER CASE WHATEVER IS 
IN STRING $ A FOLLOWFD BY THE SYMBOLS FOR 
•NOT EQUAL* AND ‘INFINITY*. 
note: $A CAN BE a MULTI-LINE STRING. 

DO NOT USE A •** AS THE FIRST 
CHARACTER 

// 44444444444444444444444444444444444444444444444444444 44 44444444444 TICK 

TICK 

syntax: tick expr 

TICK is THE SYSTEM TIM^R. TICK 60 WILL WAIT ONE 
SECOND (OR SIXTY FRAMES ON THE MOVIE CAMEPA), TICK 240 
w t i t wATT fs crrnunc. cTr . Ttr^c tnj nm nrocn m A r D r~c ad c inrAi 


Tn T uer 



♦ ZAP:<A=A+ t 
♦SKIP -1> 

IF IT IS VIP'D BECAUSE OF THE INFINITE LOOP. 

IF COMPILE PRINTS OUT AN ERROR MESSAGE STATING THAT 
THE MACRO IS NOT VIP-ABLE. 00 NOT VIP THE MACRO 

// *************************************************** ********** ******** 

/* 

BO0-HCO, WE DON'T HAVR IT 

// ***** ********** ****** *********************************** *** * * ** ***** 

// *********************** ************ * *********** ****************** WAITE0 D 

WAITFOR 

SYNTAX: WAITFOR MNAME1 ESOTERIC///// 

THE DCLOOPED MACRO CONTAINING THE "WAITFOR MNAME1" WILL WAIT 
FOR MNAMEl TO FINISH BEFORE IT CONTINUES. THIS COMMAND IS USEFUL FOR 
SYNCHRONIZING DOLOOPED MACROS. IT CAN BE USED TO DOLOOP MACROS 
WITHIN DOLOOPED MACROS TOO: 

SAM :< .... 

DOLOOP FRED 
WAITFOR FRED 
UNLOOP FRED 
. . .^ 

SAM HAS TO BE DOLOOPED FOR THIS TO OCCUR. IF THE DOLOOP/WAITFOR 
PAIR ON FRED ARE REPLACED BY A DO FPED• THE WHOLE MACRO WILL 
BF COUNTED AS A SINGLE LINE IN THE -DOLOOP I NG STRUCTURE, WHICH MAY 
OP MAY NOT BE MOPE DESIRABLE THAN FRED BEING DOLOOPED AS WELL. 

SEE HELP DOLOOP TOO. 

// *********************** ** ********************** ******************* WAIT 

WAIT 

syntax: wait esoteric///// 

WAIT CAUSES THE MACRO TO WAIT FOR THE USER TO TYPE ON THE VT05. 

IT INHIBITS THE EXECUTION OF THE MACRO UNTIL THE USER TYPES "RESUME”. 

WAIT IS USEFUL FQP INTERACTION WITH THE USER DURING THE USE OF A 
LONG MACRO. "CNTL S" EFFECTIVELY DOES A WAIT AND WAIT IS A 
PROGRAMMED |S. 

// ********************* ** **************** ******** ************ * * ***** wI no nw 

WINDOW 

SYNTAX: WINDOW PIX1,PIX2.SCALE,X,Y,Z 

WINDOW/6 P I X 1 , PIX2.SCALE,Xl,Yl,Zi,X2,Y2,Z2 

WHERE SCALE, X , Y , Z , X 1 ,YI,Z1,X2,Y2 AND Z? ARE EXPRS 


WINDOW IS A GENERALIZED SCALE WITH CLIPPING. OF POINTS 
AND LINES OUTSIDE THE BOUNDS. THE BOUNDS ARE 

-X to X, -Y TO Y, -Z TO Z, OR IN THE "/6» MODE BY XI TO X2, Yl TO Y2 
Z1 TO Z 2 • IF X, Y, Z ARE OMITTED, THE MAXIMUM SCRFEN BOUNDARIES ARE 
ASSUMED. THE FLOATING EXPRESSIOND REPRESENTS THE SCALING FACTOR 
(2.5 MEANS TWO AND ONE HALF TIMES AS BIG, .33333 MF A NS 1/3 THF SIZE). 

EACH POINT OF THE IMAGE IS FIRST MULTIPLIED BY THE SCALE FACTOR, THEN 
CLIPPED TO FIT INSIDE THE SPECIFIED BOUNDS. THE OLD IS IN NO WAY 
DISTURBED THE AUTHOR ASSUMES NO RESPONSIBILITY FOR ABSURD SCALE 
FACTORS. 

examples: - WINDOW CILL,LEDGE,3.1415,100,200,300 

WIN/6 SYLVI A,JUMP,SIN(FQ ) ,-5,25,Q, 17,00,PO 

// ************************* ** ******************** ******** ************** 

/* 

THA t ONE WAS a REAL WINNER, I NEVER HEARD OF IT... CHECK YCUR SPELLING 
JUST TO MAKE SURE YOU DIDN'T MAKE A MISTAKE ..... 

// ******************************************************************** 

// ******************************************************************** XLIF 

XL I ST 

SYNTAX: XLI5T 

THIS WONDERFUL COMMAND TURNS OFF LIST, SURPRISED???? 

// * ******** ****** *** ***************** ************ ********************* 

/* 

OK, YOU TELL ME WHAT WENT WRONG ,TUPKEY. .. ... IF YOU DON'T KNOW ASK THE 

NURD ..... 

// ********* ** ******************************************************** 

// ******************************************************************** 

/* 

YA REAL FINF. I THOUGHT EVERYBODY WHO USES GRASS KNOWS THAT Tt-ERE 
ISN'T ANY COMMAND THAT STARTS WITH A "Y". CHECK-A-YCU SPELLIN'. 

// ******************************************************************** 

// ****************************************************************** ZAPPO! 

ZAPPOI 




CNF TICK UNIT EQUALS 


1 A60 CF A SECOND 


example: 

PUTt PIX 
TICK 10 
GFTL PIX 
TICK 10 
SK -4 

THIS WILL CAUSE PIX TO FLASH ON AND OFF 3 TIMES A SECOND. 

// *************************************************** ** ** * ********** TYP C 

TYPE 


SYNTAX 1 


TYPE ONAME.EXT XX,XX 


TYPE 

THE DNAME IS 
"|C". IF NO 


TYPES THE DNAME FROM THE AREA INDICATED BY •* XX,XX *• 
TYPED ON THE VT05 AND MAY BE ABORTED BY TYPING: 

*» XX,XX " IS INDICATED, THE DEFAULT IS YOUR AREA. 


examples: type draw.mac 

TYPE PATH.DEC 

// ******************************* *********************************** TREE 

TREE 


syntax: tree 


TREE GIVES THE USER A DIAGRAM OF HIS DATA STRUCTURE. IT LISTS 
THE PICTURES AND GROUPS IN THE DISPLAYED STRUCTURE BY NAME, 

INDICATING GROUPING LEVELS AND HIERARCHIES BY TABS. 

// ******************* ** ** ** ** ******** ********************************* 

/* 

THAT IS STRANGE, I NEVER OF THAT COMMAND. YOU SURE YOU DIDN'T MESS 
UP THE SPELLING?? 

// ******************* ********* *** **** ************ **************** ***** 

// * ** ************ ****** ****** ******** ********** ** ****** ************* UNFIL*' 

UNFILM 

SYNTAX: UNFILM ESOTERIC///// 

RESETS TO NORMAL RUN MODE AFTER FILMING WAS USED. <"U" IS 
ENOUGH TO TRIGGER THIS COMMAND.) 

// A ****************** ******* ********************* ********************UNLOQF 

UNLOOP 

SYNTAX: UNLOOP MNAMEl, MNAME2, . ESOTERIC///// 

UNLCOP TAKES A MACRO OUT OF THE DOLOCP STRUCTURE. 

SEE HELP DOLOQP FOR DETAILS. 

// ******************************************************************** 

/A 

YOU ARE JUST PLAIN OUT OF LUCK IF YOU WANTED HELP WITH THAT COMMAND 

NAME, BFCUASE I DON'T HAVE ANY. CHECK YOUR SPELLING. 

// ******************************************************************** 

// ****************************************************************** VIP 

VIP 

SYNTAX: VIP CPLNAMF ESOTERIC///// 

VIP (VERY IMPORTANT PROGRAM) TAKES .CPL (COMPILED 
MACROS) AND EXECUTES THEM AT A HIGH PRIORITY AT 60 TIMES 
A SECOND OR ONCE PER TICK (IF YOU'RF FILMING. FTC). 

THE .CPL SHOULD NOT CONTAIN ANY NON-TERMINATING LOOPS UNLESS 
YOU REALLY WANT THF SYSTEM TO CEASE NORMAL OPERATION QUICKLY 
(INFINITE LOOPS AT HIGH PRIORITY LOCK OUT EVERYTHING ELSE). 

VIP IS FOR CERTAIN ANIMATION USES AND TO ELIMINATE SOME 
TYPES CF LOOPING AT '*• LEVFL. |C AND |S DO NOT WORK ON 
VIP'D MACROS. 

UP TO 30 .CPL MACROS MAY BE SET UP USING VIP. ONE MAY 
BE SET UP SEVERAL TIMES IF 60 TIMES A SECOND IS NOT EAST ENOUGH. 

DELETING T HE .CPL MACRO WILL ALSO REMOVE IT FROM TFE VIP 

LIST . 

IF VERY COMPLEX .CPL MACROS ARE SETUP THIS WAY, THF 
UPDATE RATE OF ROTATIONS, FTC.. WILL SLOW DOWN DUE TO THE 
F X T R A TIME IT TAKFS. 


examples: 

IF THE MACRO FILE LOOKS LIKE: 

*SSSt<A=00+01/256 
+B=D2*4> 

THIS WILL HAPPEN BY ITSELF EVERY 1/60 OF A SECOND 
IF you: 

♦COMPILE SSS.BIF 
♦ VIP 8 IF 






WHERE N,X,Y,Z,K ARF EXPRS 


ZAPPOI VOVRS A POINT, GIVEN OY N, TO THE NEX COORDINATES 
SPECIFIED BY X,Y,Z. THF VALUE OF N CAN R AN G c FROM l, THF FIRST 
POINT IN THE PICTURE, TO THF PICTURE * S LAST POINT, 

K IS A VARIABLE IN WHICH THE FOLLOWING IS INDICATED! 

K=0 DRAWN VECTOR 

K=1 NON-DRAWN VECTOR (JUMP) 

K=-l END OF LIST (LAST VECTOR) 


SWITCHES! /N - WORKS IN CONJUNCTION WITH 

GETPOI/N. ZAPPS THE LAST 
POINT THAT WAS GETP'D. 

BF CAREFUL NOT TO SFT K TO -l UNLESS YOU'RE SURE BECAUSE IT 
TERMINATES THF LIST, ZAPPOI IS EFFECTIVELY THE REVERSE OF GETFOIN. 

example: 

ZAPPOI LAMP,25,— 1500,—1600,500* 0 

THIS WILL ZAP THE 25TH POINT OF LAMP TO THE 
NEW COORDINATES SHOWN. 

NOTE: ZAP CAN, IN FACT, BLANK THE LAST VECTOR (K=t). 

HOWEVER, GFTPOINT WILL STILL READ IT AS K=-l SINCE IT IS THE 
END OF THE LIST. PUTDSK WILL ALSO GET CONFUSED IF THE LAST VECTOR 
IS RLANKED SO DON'T PUTDSK A PICTURE WITHOUT RE-ZAPPING 
THE LAST VECTOR TO K=-1. 

AN EXAMPLE OF HOW TO USE GETP AND ZAP TOGETHER: 

N = 0 

%FOC N=N+1 

GETP PI X,N,X,Y,Z,K 

IE KW-l.ZAP PIX.N,X*2,Y*2,Z*2,K 
SK JSEQO 

THIS WILL DOUBLE THE SIZE OF THE PIX. 

// * ************ ******** ** ********************************* ********* * ZA PTE X 

ZAOTEXT 

SYNTAX: ZAPTEXT PIX,$VAP1,$VAR2 

ZAPTEXT SEARCHES THF PIX FOR SVARl, DISPLAYED AS TEXT AND 
REPLACES IT WITH SVAR2. IE IT IS NOT FOUND, THE COMMAND EXITS WITH AN 
ERROR. THIS COMMAND DOFS NOT ALWAYS WORK—COMPLAIN AND WE MAY FIX IT. 

// **********$***$********************4E**$*$*$*$*:$*;**4;$$$:4;$$ ** * * ** *** 

/* 

NO DESCRIPTION IS AVAILABLE FOR THIS COMMAND AT THIS TIME. 

// ****************************************************************** 


1. E.PIX->>> EPROR l 

THIS NAME CANNOT BE FOUND-CHECK SPELLING OR DIRCOR 

2. E.CMD->>> ERROR 2 

THIS COMMAND NAME CANNOT BE FOUND-—CHECK SPELLING AND HELP 

3 , E • SWH->>> ERROR 3 

THIS SWITCH IS NOT DEFINED FOR THIS COMMAND 

4, E.SYN->>> ERROR 4 

UNDIAGNOSIABLE SYNTAX ERROR-SEE HELP COMMAND 

5, E.IJNF->>> ERROR 5 

MORE INFORMATION NEEDED FOR THIS COMMAND—SEE HELP COMMAND 

6, F.0VP--->>> FRRCR 6 

TOO MUCH INFORMATION GIVEN—PLEASE LOG THIS ONE AS A RUG 

7, F.NID ->>> ERROR 7 

INPUT DEVICE NOT AVAILABLE 

10,E.NOD-»> ERROR 8 

OUTPUT DEVICE IS NOT AVAILABLE 

11 , E.N IF--->>> ERROR 9 

THIS NAME DOES NOT EXIST ON THE DISK—-CHECK DIRDSK 

12. E.N0F->>> ERROR 10 

THIS NAMF is ALREADY ON DISK OR NOT LOGGED INTO 1,1 

13. E.CAR->>> ERROR 11 

COMMAND GOT CONFUSED WITH FUNNY CHARACTER-CHECK TYPING 

14. E.NCS->>> ERROR 12 

THIS FILE IS not A CHARACTER S-T 

15. F.CCE->>> ERROR 13 

SYSTEM SPACED OUT--NO STORAGE LEFT—DELETE SOMETHING 

lfi.^.TYP->>> ERROR 14 

THIS NAME EXTENSION IS NOT VALID—SEE HELP GETDSK 

17, E. M AX->>> ERROR 15 

TOO MANY NAMES USED—DELETE SOMETHING 

20, E.DEV->>> ERROR 16 

A DEVICE OR VARIABLE NAME IS EXPECTED HERE 

21. E.NFX->>> ERROR 17 

THE PICTURF/MACRO DUALITY HAS BEEN CONFUSED-CHECK DIRCOR 

22, E.STR->>> ERROR 18 

THE DISK HAS NOT BEEN INITIALIZED FOR YOUR AREA-SEE TOM 

23. E.PRV->>> 

T u tc D TrTiior m amc At nr a nv 


tm i ic r-r ur ri/ 


r> r on" nn o dcmaut 


ERROR 19 






















ONLY OTSPLAYFD PICTURPS MAY BE- PUTLIB'D 

25. F.GLB->>> ERROR 21 

ONLY NON-OISPLAYED (PUTLIB'D) PICTURES MAY BE GETLIB'D 

26. F. MIS-->>> FRF OR 22 

THERE IS A COORDINATE MISSING IN THE INPUT DATA 

27. E.0FL->>> ERROR 23 

X.Y.Z MAX/MIN ARE 2047/-2048 RESPECTIVELY 

30. E.LTM- >>> ERROR 24 

THERE IS A LINE TERMINATOR MISSING—CHECK INPUT CAREFULLY 

31, E. MAC- >>> ERROR 25 

THIS MACRO HAS GONE ASTRAY—CHECK LOGIC AND SYNTAX 

7 0 ET wPW---- —NS'S CDOpD OA 

THIS *C CMMANO DOES NOT WORK WITH PICTURES 

33, F.N3D->>> ERROR 27 

DATA NOT IN 3D SHADE FORMAT 

34, E,BSP- »> ERROR 29 

SOFTWARE CHARACTER SET JUMBLED 

35, E.NPT- ->>> ERROR 29 

LINE OVER 80 CHARACTERS LONG ASKED TO EXECUTE-SHORTEN IT 

36, E.CPT- >>> ERROR 30 

THERE IS A MISSING = »S SIGN HERE 

37, E,DMT->>> ERROR 31 

THIS DEVICE DOES NOT EXIST AS SPELLED ABOVE 

40. E.RAD- »> ERROR 32 

THIS NUMBER HAS INVALID CHARACTERS IN IT—CHECK TYPING 

41. E.UGP->>> ERROR 33 

THIS COMMAND IS FOR PIX WITH VECTORS ONLY (NO COPIES, NO GROUPS). 

42. E.UFN->>> ERROR 34 

THIS FEATURE DOES NOT WORK IN THIS COMMAND YET. 

43. E.TXT- >>> ERROR 35 

ILLEGAL VG CHARACTER SPECIFIED IN <XXX>. 

44. E.NGS- >>> ERROR 36 

A STRING IN SINGLE QUOTES (») OR A $VAR IS EXPECTED HERE 

45. E.NDS- >>> ERROR 37 

ONLY DISPLAYED PICTURES MAY BE GROUPED. 

46. E.WW0->>> ERROR 38 

THIS COMMAND WORKS ONLY WITH PICTURES 

47. E.AXS- >>> ERROR 39 

ROTATE REQUIRES AN AXIS (EXCEPT /X./Y./Z MODES) 

50. E.TXG->>> ERROR 40 

CLOSING ANGLE BRACKET (>) NOT FOUND. 

51. F.OVF--—>>> ERROR 41 

YOU CAN'T EXECUTE A NULL STRING 

52. E.GRB- »> ERROR 42 

BINARY FILE TS NOT A PICTURE OR IS GARBLED 

53. E.PRO- >>> ERROR 43 

ONLY GOD CAN WRITE ON HERE. (UNLESS YOU KNOW HIS PASSWORD) 

54 , F • C NT- ->>> ERROR 44 

ONLY YCUP OWN FILES CAN BE DELETED OR RENAMED 

55. E.CAL-»> ERROR 45 

PICTURE CONTAINS SUBROUTINE CALLS & CANNOT BE WRITTEN 

56. E.UNP- >>> ERROR 46 

THIS PICTUPF TS SOMEHOW IN NON-STANDARD FORMAT 

57. E.NMC->>> ERROR 47 

MA CP O MUST BE IN PROGRESS FOR THIS COMMAND TO WORK 

60, E.IVN- >>> ERROR 48 

THIS NAME HAS AN INVALID CHARACTER IN IT (A-Z & 0-P ONLY) 

61, E.FOR->>> ERROR 49 

ONLY V ARI ABLE NAMES APE ALLOWED LEFT OF THE " = ** SIGN 

62, E.ARC,- >>> ERROR 50 

NO ARGUMENT DELIMITER SEEN WHERE EXPECTED-—CHECK SPELLING 

63, F . C,F Z- >>> ERROR 51 

ONLY VARIABLES CAN OE WRITTEN TO—DEVICES CAN ONLY BE READ 

64, c # RUK->>> ERROR 52 

GETPOI CP ZAPPOI INDEX OUT OF BOUNDS 

65 ,0.0 PP->>> ERROR 53 

ATTEMPT TO CREATE NEW 'OPENO' BF FORE CLOSING THE OLD ONE 

66 , E • N 00->>> ERROR 54 

ATTEMPT TO GENERATE A POINT WHEN NO 'OPENO* IS IN PROGRFSS 

67.E.IVG->>> FRROR 55 

CAN'T OUTPUT THIS PIX AS .DEC—HAS TEXT OR IS NOT CLOSED 

70. E.ESE---■->>> ERROR 56 

FUNCTION SWITCH NUMBER GREAT ER THAN 15 

71. E.DNA->>> ERROR 57 

$A TO SZ ONLY ALLOWABLE NA MR S VARIABLES 

72. E.SWP->>> ERROR 58 

GROUPING FRPOR—RESTART AND CHECK TREE NEXT TIME 

73. E.XXX- >>> ERROR 59 

PSEUDO-LABEL ERROR DETECTED BY COMPILE C CM MA NO 

74. E.XXX->>> ERROR 60 

THE ABOVF PSEUDO-LABEL IS NOT FOUND 

7E.E.XXX- »> ERROR 61 

*****LCG this ONE—CAN'T FIGURE IT OUT 

76, F.XXX->>> ERROR 62 

EDITOR FILE ALREADY Oprn (TYPE REST) 

77, E.XXX->>> ERROR 63 

No pnlTnp pti c mac hp roFwnri 













































MAXIMUM NUMRF P (20) OF PUSHFS EXCEEDED—POP SOMETHING 
ONLY EDITOR FILFS MAY PE CLOSED'D 

J Q 2 ^ ^ ^ M „______,_,_-r,_ m -nr -mm nrnr-n_r-ir-'rr-TT-rr _,-ir-i_ 

DIRECTORY CANNOT BE DECODED ON THIS DEVICE 

103. XXX--- 

FILE EXTENSION AND DATA TYPE DO NOT MATCH 

104, XXX- 

ONLY SWAP MODULES MAY BE MADE CORE-RESIDENT 

^ Q ^ ^ XX X ~ *" ~~ -W-I--I m -mr -n —i r m mm m , -t lT - r. n, -t- wt- m* -m mm mm mm mm ^ »m mm ... ~a- ,m um — 

ILLEGAL VG CHARACTER SIZE l TO 8 ONLY ALLOWED 

106,XXX- 

POPPING WITHOUT PUSHING (ENOUGH) IS NOT MAKING SENSE 

1 07,XXX- 

A $VAF MUST BE SPECIFIED HERE 

X 1 0 f X X X — , — T - rr » -rn, 1— mm i r . mm mm rrr -m r. — -r-, — mmm m mm r- -ir» ^ .. rm| „ _ M | T | .... 

FPP: ILLEGAL OPERATOR IN EXPRESSION 

1 11 ,xxx- 

fpp: incomplete expression 

2 2 2« XX X ~mmm-m.mmm.mm’mmm.— « _ 1 — ,r -r ■■ -m IT T -m mm mm m, m, mm —, mm u mm —! ■- iiw _l mm mm mmm mm 

FPP: unbalfnced parenthesis 

l l 3, XXX-- 

fpp: illegal floating constant 

1 14,XXX- 

fpp: INVALID OPERAND IN EXPRESSION 

X X 5 XXX—" "'" 1,1 ■" ■■ r—T -IT- -n mm — r mm — — i — — _ , u n -,-n , mi ,,, ^ „ 

fpp: no argument SPECIFIED on function call 

1 1 6, XXX--- 

fpp: DIVISION BY ZERO ATTEMPTED 

1 I 7, XXX-- 

FPP: FLOATING to INTEGER CONVERSION ERROR 

X 2 0 * X ^ , _U mn ^ - ■■■■ I. I T, - B - M. mm mm mm mm n- --■» m mm mm m ■ nn. hi —■ mm m m -mm ■» -mm rnm 

FPP: ATTEMPT TO TAKE THE LN OF ZERO 

121,XXX- 

FPP: SQR OF A NEGATIVE NUMBER IS IMAGINARY 

12 2, XXX--- 

THIS name DOFS NOT EXIST ON TAPE 

123, XXX--- 

THIS NAME CANNOT NOW BE USED ON TAPE (MAY ALREADY EX 

124, XXX- 

THE TAPE HAS MOT BEEN INITIALIZED FOR YOUR AREA - SE 

125, F.CPL- 

ONLY CPL FILES CAN 8E 'EXECUTED* 

X ^ ^ ^ J. U - ^ BaMJ>Ma lM wu|ulJ1 | M Iim | ' ^ ^ | r | ^ ^ _ || | _L . -r L _ I 

compilf: invalid statement syntax 

127,XXX- 

compilf: invalid LINE FND CP line syntax, CHECK MACR 

130, XXX- 

compilf. goofed, please log this BUG 

131, XXX- 

COMPILE will not process all of your MACRO - SEE TOM 

1 32 ,XXX- 

COMPILE: MISSING OPERATOR in putpoi,getpci,or zappoi 
1 33,XXX- 

compile: illegal operator IN floating EXPRESSION 

134.XXX- 

compile: incomplete floating expression 

l 35, XXX-- 

compile: unbalfnced parenthesis in floating EXPRESSI 

136 , XXX--- 

COMPILE: ILLEGAL FLOATING CONSTANT 

137,XXX- 

compile: INVALID OPERAND in floating expression 

140,XXX- 

MAX STFING CFNGTH (8000 CHARACTERS) FXCEEDED 

1 A l ,XXX-- 

attempt to ACCESS NEGATIVE LOCATION IN STRING 

1 & 2 ,XXX- 

TADGET string IS NULL 

1 43,XXX- 

MATCH STRING IS NULL 

144, XXX- 

BUMP ONLY WORKS IF £A IS A-Z,VA-VZ#WA-WY,FA-FY,AA-AY 

145, XXX-- 

TARGET IS NOT A 'LINED' STRING 

156,XXX- 

ERROR IN POPPING-SFF HELP POPVAR 

160, XXX->- 

COMPILF: NO AGRUMENT SPECIFIED ON FUNCTION CALL 

161, XXX- 

ARRAYS AFE AA-A 7 ONLY 

162, XXX- 

UPDFR BOUND OF the ARRAY IS TOO LARGE OR SOMETHING 

163, XXX- 


164,XXX-— 

SlIBCrCTOTC no. 


—>>> 

ERROR 

65 

— >>> 

ERROR 

6 6 

— >>> 

ERROR 

67 

— >>> 

ERROR 

6 8 

— >>> 

ERROR 

69 

—>>> 

ERROR 

70 

— >>> 

ERROR 

71 

— >>> 

ERROR 

72 

—>» 

ERROR 

73 

—>>> 

ERROR 

74 

—>>> 

ERROR 

75 

— >>> 

ERROR 

76 

-->>> 

ERROR 

77 

—>» 

ERROR 

78 

—>» 

ERROR 

79 

— >>> 

ERROR 

80 

—>>> 

ERROR 

81 

—>>> 

ERROR 

82 

—>>> 

EPRCR 

83 

ST) 

— >>> 

ERROR 

84 

: TOM 

->» 

ERROR 

85 

—>>> 

ERROR 

86 

—>» 

ERROR 

87 

—>>> 

ERROR 

88 

— >>> 

ERROR 

89 

-->>> 

ERROR 

90 

-->>> 

ERROR 

91 

—>>> 

ERROR 

92 

—>>> 

N 

ERROR 

i 

93 

->>> 

ERROR 

94 

->>> 

ERROR 

95 

->>> 

ERROR 

96 

— >>> 

ERROR 

97 

->>> 

ERROR 

98 

— >>> 

ERROR 

99 

->>> 

ERROR 

1 00 

LA-LY 

->» 

FPPOP 

10 1 

— >>> 

ERROR 

1 l l 0 

— >>> 

ERROR 

1 12 

—>>> 

ERROR 

l 13 

->>> 

ERROR 

1 14 

— >>> 

ERROR 

1 15 

SORRY. 

->>> 

ERROR 

1 16 


TCD«IM»TCn WT-rt 


« » » o c 














































COMPILE: nested MACROS are MOT" allowed in cpl files 

167, XXX->>> 

TOO MANY SUBSCRIPTS HAVE BEEN SPECIFIED FOR THIS ARRAY 

170,XXX->>> 

THE SYSTEM THINKS THIS IS AN ARRAY, BUT IT * S NOT 

171 ,XXX- —>>> 

NOT ENOUGH SUBSCRIPTS ARE SPFCIFIFD FOR THIS ARRAY 

172, XXX- >>> 

ARRAY SUBSCRIPT OUT OF BOUNDS 

173, CCC->>> 

THIS ARRAY HAS ALREADY BEEN DIMENSIONED 

174 ,XXX->>> 

ARRAY SPEC IFIFD ISN'T BEEN DI MENSICNED--USE ARRAY COMMAND 

176 ,XXX- >>> 

THE VALUES OF DIALS AND ARRAYS CANNOT BE TRACEO. 

177, XXX- >>> 

LOCAL VARIABLES CAN ONLY BE USED WITHIN MACROS. 

200, XXX->>> 

THE MAXIMUM NUMBER OF TRACES HAS BEEN EXCEEDED. 

20 1 , XXX->>> 

YOU CAN'T DCLOOP THE SAME MACRO TWICE 

202 , XXX->>> 

MAXIMUM NUMBER OF THINGS TO DCLOOP IS 10 

203 ,XXX->>> 

CANNOT UNLOOP SOMETHING THAT ISN'T DOLOOPED 

204, XXX----->>> 

CANNOT WAITE OR SOMETHING THAT ISN'T DOLOOPED 

205,ODD- >>> 

THIS ERROR IS IMPOSSIBLE 

21 0,XXX->» 

PUTDSK OF ARRAYS NEEDS SECOND ARGUMENT -- SEE HELP PUTDSK 

1 t X X X "** ** '■ - n — r — MU r .... — mm mm, t — — — t tt -r-r -tt tt- irr -it m » -r Tt ■ nr rr w -■ ■» »» in i n» -i— m - N, ^ ^ 

CORE ALLOCATION IS CONFUSED BY THIS DELETION—RESTART 

2 Q ^ f XX X n i m -m mi r in m. i « mini n- — i i .jui « uu ~r t- M rM „„ , _ |J _ | . L , ± B±J t| ^ 

SOMEHOW THE NAMF TO BE DELETED WAS LOST——TRY RESTARTING 

212, XXX- >>> 

FIRST PICTURE IN GROUP COMMAND NOT DISPLAYED 

213, XXX- >>> 

SECOND PICTURE IN GROUP COMMAND NOT DISPLAYED 

2 J T X X X " ~ rr * - -i— , ~i— tt - -t -T ,B -1 M «r r^nrrn i » — ir_ w ~• -mt ~rr -w- -i- rr i -m-t--r-Tnr-ir»— 

PIX TO BE GFOUPFD MUST BE ON SAME LEVEL (CONSULT TREE) 

216,000->>> 

I FORGOT 

-217,000- >>> 

I FORGOT 

220,000 ->>> 

YOU CAN'T GET A LOCAL VARIABLE THAT DOESN'T EXIST YET 

221,000 -->>> 

NOT ENOUGH SPACE FOR COPY/V OR IS NOT COPIABLE 

222,000 -->>> 

YOU CANNOT COPY COPIES—COPY THE ORIGINAL 

223,000- >» 

PIX IS NOT PUTLTB'D 8UT ISN'T DISPLAYED EITHEP—GIVP UP 

224,000->>> 

CHECK THIS DISK FILE CAREFULLY—ERROR DETECTED IN WRITING 

225,000- >>> 

THE DISK IS FULL—FILE MAY BE INCOMPLETELY WRITTEN OUT 

22 6 , 00 0 -->>> 

DELETE THINKS THIS PIX IS PUTLIB'D BUT IT'S NOT—GIVF UP 

227,000->» 

GFTPOINT IS CONFUSED BY PIX THAT AREN'T CLOSED—CLOSE IT 

230 ,PPP--->>> 

GRASSB DOESN'T HAVF. FLOATING POINT V ARIABLFS—USE GRASS/GRASS 2 

300,XXX->>> 

SOFTWARE POINTERS CRAPPED UP-RESTART (GOON) 

30 1 , XXX->>> 

SOFTWARE CRAPPED UP POINTERS—GIVE UP (UPOON) 

302, XXX- >>> 

SOFTWARE CRAPPFD UP POINTEPS-GIVF UP (UPBAD) 

303 , XXX->>> 

SOFTWARE CRAPPED UP POINTERS-GIVE UP (NEAP UPDOT T ) 

304 , XXX->>> 

GROUPING SCREWFD UP — GIVE UP (UPDO IT) 

305, XX X->>> 

BAD CHAINING-GIVF UP (UPDOIT) 

31 3, XXX->>> 

SYSTEM CAN'T HARDWARE DECK AIN—GIVE UP (HCHNOK) 

-0 

PLEASE LOG THIS ERROR CAREFULLY IN THE BUG LOG—TOM 
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1 19 

ERROR 

120 

ERROR 

121 

ERROR 

122 

FPPOR 

1 23 

ERROR 

124 

ERROR 

126 

ERROR 

127 

ERROR 

128 

ERROR 

129 

ERROR 

130 

ERROR 

131 

ERROR 

132 

ERROR 

133 

ERROR 

1 36 

ERROR 

137 

ERROR 

l 34 

ERROR 

138 

ERROR 

1 39 

ERROR 

141 

ERROR 

142 

ERROR 

143 

ERROR 

1 44 

ERROR 

1 45 

ERROR 

1 46 

ERROR 

147 

ERROR 

148 

ERROR 

1 49 

ERROR 

1 50 

ERROR 

151 

FRROR 

1 52 

ERROR 

1 92 

ERROR 

193 

ERROR 

194 

ERROR 

195 

ERROR 

1 96 

FRROR 

197 

ERROR 

203 










































